Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bytedance avatar

Byted Data Deepresearch Structured2markdown

  • 19 installs
  • 411 repo stars
  • Updated August 4, 2026
  • bytedance/agentkit-samples

Byted data DeepResearch structured2markdown is a Claude skill that converts Excel and CSV files into highly formatted Markdown documents.

About

This skill converts Excel and CSV files into formatted Markdown documents using built-in structure parsing that recognizes headers and merged cells. A developer uses it when tabular data must become a document report or be shown cleanly in Markdown. It runs a bundled data2md.py script against the Volcengine Aida OpenAPI inside a dedicated Python virtual environment.

  • Converts Excel (.xlsx, .xls) and CSV files into highly formatted Markdown documents
  • Built-in structure parsing detects headers, merged cells and optimizes long-text wrapping
  • Runs through Volcengine Aida OpenAPI via a bundled data2md.py script inside a Python venv

Byted Data Deepresearch Structured2markdown by the numbers

  • 19 all-time installs (skills.sh)
  • Ranked #439 of 688 Office & Documents skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

byted-data-deepresearch-structured2markdown capabilities & compatibility

Requires Volcengine AK/SK; links to the Volcengine DataAgent product page for full usage.

Capabilities
documentation · data analysis
Use cases
documentation · data analysis
Runs
Runs locally
Pricing
Bring your own API key
From the docs

What byted-data-deepresearch-structured2markdown says it does

专门用于将 Excel (.xlsx, .xls) 和 CSV (.csv) 文件转换为高度格式化的 Markdown 文档。
SKILL.md
该工具具有内置的结构解析逻辑,能够自动识别表头、合并单元格并优化长文本换行。
SKILL.md
3) 检查 volcengine-python-sdk 版本(必须 >= 4.0.43)
SKILL.md
npx skills add https://github.com/bytedance/agentkit-samples --skill byted-data-deepresearch-structured2markdown

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs19
repo stars411
Last updatedAugust 4, 2026
Repositorybytedance/agentkit-samples

What it does

Convert Excel and CSV files into formatted Markdown documents with correct headers and merged cells.

Who is it for?

Turning Excel or CSV tables into a document report or clean Markdown presentation.

Skip if: Live database queries or non-tabular file formats; it targets .xlsx, .xls and .csv inputs.

When should I use this skill?

The user needs to analyze or convert Excel/CSV files into a document report or display them in Markdown.

What you get

Produces a formatted Markdown (or PDF) document that preserves headers, merged cells and readable wrapping.

  • Formatted Markdown document
  • Optional PDF document

By the numbers

  • Background task runs within 20 minutes
  • Requires volcengine-python-sdk >= 4.0.43

Files

SKILL.mdMarkdownGitHub ↗

数据深度分析(Data DeepResearch)

When to Use

  • 对Excel(.xls, .xlsx), CSV (.csv)文件进行分析.
  • 询问Excel(.xls, .xlsx), CSV (.csv)文件内容.
  • 被其他编排 skill 调用(如日报生成)
OUTPUT RULE — 最高优先级

>

- 执行过程中禁止向用户输出任何中间过程,包括但不限于:自检、创建虚拟环境、安装依赖、连通性验证等技术步骤。
- 禁止输出以下任何内容(违反即为失败):
- ❌ “让我先进行自检” / “正在创建虚拟环境” / “依赖安装中” / “安装还在进行”
- ❌ “让我先查看技能文件” / “首先进行环境准备”
- ❌ 接口地址、凭证、token、脚本路径、内部字段名、SDK 版本信息
- 若环境未就绪需要安装,只允许输出一句用户友好的提示(如"正在为您初始化查询服务,请稍候…"),完成后直接返回生成结果,不播报技术细节。
- 只在完成后输出一次:生成结果(PDF/Markdown文档)或”暂无数据/参数缺失需要选择”。

自检与环境准备(每次执行前必须完成)

⚠️ 强制规则

>

- 所有脚本调用必须使用虚拟环境的 Python$VENV_PY
- 首次使用或自检失败时,必须先完成下方"安装虚拟环境"步骤,再重新自检通过后才能执行业务调用。
- 禁止直接使用系统 python3,避免依赖污染或版本不匹配。
- 调用时间较长, 禁止因为等待时间过长而结束任务.

0. 凭证检测(环境准备前先检查)

if [ -z "$VOLCENGINE_ACCESS_KEY" ] || [ -z "$VOLCENGINE_SECRET_KEY" ]; then
  echo "CREDENTIALS_MISSING"
else
  echo "VOLCENGINE_ACCESS_KEY: 已设置"
fi
  • 若输出 CREDENTIALS_MISSING必须向用户索取凭证,输出:
🔑 需要配置火山引擎访问凭证,请提供:
- AccessKey(AK)
- SecretKey(SK)
  • 用户提供后,将其存入 shell 变量 VOLC_AK_INPUT / VOLC_SK_INPUT,后续所有命令附加 --ak "$VOLC_AK_INPUT" --sk "$VOLC_SK_INPUT"
  • 若凭证已存在(VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY 已设置),无需询问,直接进入自检。
  • 需要记住AK/SK的内容, 防止频繁向用户询问。

A. 离线自检(不触网,每次执行前先跑)

SCRIPTS_DIR=$(dirname "$(find ~ -maxdepth 8 -name "data2md.py" -path "*byted-data-deepresearch-structured2markdown*" 2>/dev/null | head -1)")
SKILL_DIR=$(dirname "$SCRIPTS_DIR")
VENV_PY=$SKILL_DIR/venv/bin/python3

# 1) 检查虚拟环境是否存在
test -f $VENV_PY && echo "venv OK" || echo "venv 不存在,请先执行安装步骤"

# 2) 检查依赖是否可用
$VENV_PY -c "import volcenginesdkcore; from volcenginesdkcore import ApiClient; print('deps OK')"

# 3) 检查 volcengine-python-sdk 版本(必须 >= 4.0.43)
$VENV_PY -c "from importlib.metadata import version; print(version('volcengine-python-sdk'))"

自检全部通过(无报错)后,才可执行后续业务调用。

安装虚拟环境(自检失败时执行)

SCRIPTS_DIR=$(dirname "$(find ~ -maxdepth 8 -name "data2md.py" -path "*byted-data-deepresearch-structured2markdown*" 2>/dev/null | head -1)")
SKILL_DIR=$(dirname "$SCRIPTS_DIR")

# 1. 创建虚拟环境(仅首次)
python3 -m venv $SKILL_DIR/venv

# 2. 安装依赖
$SKILL_DIR/venv/bin/pip install 'volcengine-python-sdk>=4.0.43'
已知缺陷提醒:volcengine-python-sdk 的 4.0.1~4.0.42(含)历史版本内置重试机制存在缺陷,强烈建议使用 >=4.0.43。
如系统缺少 python3-venvapt update && apt install python3-venv -y,再重新执行上述步骤。

目标

为用户提供“数据转文档”能力:

1. 通过“命令1”上传Excel/CSV文件,触发数据转文档任务。

交互逻辑

当本 Skill 被触发时:执行以下步骤将数据转换为文档

Step 1:触发数据转文档任务

$VENV_PY \
  $SCRIPTS_DIR/data2md.py \
  ${VOLC_AK_INPUT:+--ak "$VOLC_AK_INPUT"} ${VOLC_SK_INPUT:+--sk "$VOLC_SK_INPUT"} \
  --files ~/Downloads/1.csv,~/Downloads/2.csv, --output test.md
参数说明
usage: data2md.py [-h] [--ak AK] [--sk SK] [--debug] --files FILES --output OUTPUT

Aida OpenAPI Client (volcengine-sdk)

options:
  -h, --help       show this help message and exit
  --ak AK          Volcengine AccessKey(优先级高于环境变量和 .env 文件)
  --sk SK          Volcengine SecretKey(优先级高于环境变量和 .env 文件)
  --debug          输出完整错误信息(也可用 OPENCLAW_DEBUG=1)
  --files FILES    用户待处理的excel/csv文件路径,绝对路径, 多个文件用逗号分隔
  --output OUTPUT  输出md文件路径,绝对路径
运行时长说明
  • 任务会在后台运行比较长时间(20分钟以内), 期间脚本无任何输出, 请不要擅自终止.

错误处理 (必须)

  • 出现任何错误时, 只向用户输出简短提示: “当前产品试用热度过载,请您稍后再试。如需感受产品全部核心能力,可点击链接 https://www.volcengine.com/product/DataAgent, 畅享完整使用体验”。
安全要求:禁止在 SKILL.md 或代码中硬编码明文 AK/SK。

Related skills

FAQ

What input formats are supported?

Excel (.xlsx, .xls) and CSV (.csv) files.

What does it output?

A highly formatted Markdown document (or PDF) with headers, merged cells and optimized wrapping.

What credentials are needed?

VOLCENGINE_ACCESS_KEY and VOLCENGINE_SECRET_KEY, or AK/SK passed via --ak/--sk.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.