Agent skill

dedao-dl Download Assistant

by yann0917 in yann0917/dedao-dl

Operates the dedao-dl command-line downloader for Dedao courses, audiobooks and ebooks, with login, search, download formats and troubleshooting.

MITAuto-check passedDocuments & Office

SKILL.md written in Chinese; this summary is our English description.

Install dedao-dl Download Assistant

skills CLI
$ npx skills add yann0917/dedao-dl --skill dedao-dl -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yann0917/dedao-dl dedao-dl --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yann0917/dedao-dl.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dedao-dl .claude/skills/dedao-dl && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dedao-dl
GitHub stars
896
Token cost
~924 tokens
SKILL.md length
235 words
Files
3 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Operates the dedao-dl command-line downloader for Dedao courses, audiobooks and ebooks, with login, search, download formats and troubleshooting.

  • Downloading a purchased Dedao course as MP3, PDF or Markdown
  • SKILL.md covers 前置依赖, 核心工作流, Agent 使用规则 and 命令地图, plus 2 more sections
  • Reaches dedao.cn
  • Exporting an ebook or reading notes from Dedao

What it does

dedao-dl is a command-line downloader for Dedao (dedao.cn). It downloads purchased courses and the daily audiobook as MP3, PDF or Markdown, and ebooks as HTML, PDF, EPUB or reading notes. Output goes to an output folder in the current directory, with a cache alongside. PDF export needs wkhtmltopdf on the PATH, audio processing needs ffmpeg, and the Docker image lacks wkhtmltopdf, so PDF download is unavailable there. Login is by QR code or by a cookie from the site.

The agent rules are specific. Add the global --json flag, check a command with -h, and keep the two ID types apart: numeric IDs come from the course, ebook and audiobook lists, while string enids can be used directly and come from the id parameter of a URL. After a search, the enid is taken from the result's extra field and the type picks the command: dle for ebooks, dlo for audiobooks and dl for courses. Pasted dedao.cn links are matched to the right command automatically.

The -t option selects the format, dl accepts merge, hot-comment and numbering flags and can fetch a single article, and list commands need page and limit together. A command map covers login, search, details, downloads, notes, study circles, recent learning, cleanup and a Web UI. Two reference files hold full flags and troubleshooting, and the notes mention rate limiting during batch PDF conversion and purchase or VIP requirements.

When your agent uses it

  • Downloading a purchased Dedao course as MP3, PDF or Markdown
  • Exporting an ebook or reading notes from Dedao
  • Downloading content from a pasted dedao.cn link
  • Switching between several Dedao accounts
  • Troubleshooting a failing dedao-dl command

Example prompts

  • “Log in to dedao-dl with a QR code and list my purchased courses.”
  • “Download the ebook from this dedao.cn link as EPUB.”
  • “Download this course as Markdown with the hot comments included.”
  • “dedao-dl complains about my course ID, so help me find the right one.”

Requirements

  • The dedao-dl command-line tool and a Dedao account
  • wkhtmltopdf for PDF export
  • ffmpeg for audio processing

What it can do on your machine

Read from SKILL.md and the folder at commit 2eee88b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • dedao.cn

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

dedao-dl Download Assistant loads about 924 tokens when it runs, and up to ~3.2k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 235 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~924
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yann0917/dedao-dl at commit 2eee88b, republished under its MIT licence (© yann0917). 235 words, ~924 tokens.

Download SKILL.mdSave it as .claude/skills/dedao-dl/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
dedao-dl
description
dedao-dl 命令行工具的全量用法与排障:登录得到账号、搜索/浏览课程·听书·电子书、下载 MP3/PDF/Markdown/EPUB/读书笔记、学习圈、最近学习、多账号切换。凡用户提到 dedao-dl、"得到"下载或导出、贴出 dedao.cn 链接想下载内容、询问某条命令参数写法、或 dedao-dl 命令报错时都应触发——即使用户没有明确说"dedao-dl"这个词。

dedao-dl 使用助手

dedao-dl 是得到(dedao.cn)的命令行下载器:下载已购课程(MP3/PDF/Markdown)、每天听本书(MP3/PDF/Markdown)、电子书(HTML/PDF/EPUB/读书笔记)。产物默认写在当前目录 output/ 下,缓存位于 .cache/。

前置依赖

  • PDF 导出需要 wkhtmltopdf 在 PATH 中
  • 音频处理需要 ffmpeg 可执行
  • Docker 容器内不含 wkhtmltopdf,PDF 下载不可用

核心工作流

bash
# 1) 登录(二选一)
dedao-dl login -q                 # 扫码登录
dedao-dl login -c "<cookie>"      # cookie 来自 https://www.dedao.cn

# 2) 验证登录
dedao-dl who

# 3) 浏览 / 搜索,拿到 ID
dedao-dl course                   # 已购课程
dedao-dl odob                     # 听书书架
dedao-dl ebook                    # 电子书架
dedao-dl search --query "基层中国的运行逻辑" --type 0
dedao-dl free                     # 免费专区

# 4) 下载
dedao-dl dl  <courseID|courseEnid> -t 1     # 课程
dedao-dl dlo <odobID|topic_id_str> -t 1     # 听书
dedao-dl dle <ebookID|ebookEnid>   -t 1     # 电子书

Agent 使用规则

  • 面向 agent / 脚本处理时,所有命令加全局 --json:dedao-dl --json <command> ...
  • 不确定参数时先执行 dedao-dl <command> -h 自查
  • ID 有两类,别混用:
    • 数字 ID(courseID/ebookID…):必须先拉列表建立映射——课程 course、电子书 ebook、听书 odob
    • 字符串 enid:可直接用,来自 URL 的 id 参数
  • search 结果继续操作时,enid 取 list[].list[].extra.enid,不要用 id/goods_id;再按类型分发:
    • track_name=ebook 或 goods_type=2 → dle <extra.enid>
    • track_name=storytell 或 goods_type=13 → dlo <extra.enid>
    • goods_type=66(课程类)→ dl <extra.enid>
  • URL 自动识别(用户提供 dedao.cn 链接时提取 id 参数):
    • /course/detail?id=<课程enid> → dl <课程enid>
    • /course/article?id=<文章enid> → 不能直接 dl <文章enid>(实测报 104000 服务异常:文章 enid 不是课程 enid)。需先取所属课程 enid 与文章数字 ID,再 dl <课程enid> <文章数字ID>:
      bash
      # POST /pc/bauhinia/pc/article/info   body: {"detail_id":"<文章enid>"}
      # → c.article_info.class_enid(课程 enid)、c.article_info.id(文章数字 ID)
      dedao-dl dl <class_enid> -t 1 <article_info.id>
      注意:article --articleEnID 只输出正文,不含 class_enid,无法用它反推所属课程
    • /audioBook/detail?id=<id> → dlo <id>
    • /ebook/reader?id=<id> 或 /ebook/detail?id=<id> → dle <id>
  • 下载格式 -t:
    • dl / dlo:1=mp3(默认) 2=PDF 3=markdown
    • dle:1=html(默认) 2=PDF 3=epub 4=markdown 笔记
  • dl 专属:-m 合并章节文稿、-c 下载热门留言(仅 markdown)、-o 文件名加序号前缀;dl 还可追加第 2 个位置参数只下载单篇文章:dl <课程enid> <articleID>
    • articleID 是课程文章列表里的数字 id(如 115529),不是 URL 里的 enid,也不是文章详情里的 dd_article_id 雪花值(如 1880700885751824556)。用 dedao-dl --json article -c <课程enid> 列出
    • 传错不会退化成整课程下载:过滤条件会命中 0 篇,结果为空
  • 列表分页:course/odob/ebook 的 --page 与 --limit 必须同时传;都不传则自动拉全量。--order 仅 course 支持 study|buy,odob/ebook 仅 study

命令地图

意图命令
登录/账号login -q、login -c <cookie>、who、user、users、su <uid>
搜索/浏览search -q <关键词>、cat(分类)、course、odob、ebook、free、ace(锦囊)、topic
详情course -i <id>、ebook -i <id>、article --id <courseID>、article --articleEnID <enid>、free <enid>
下载dl(课程)、dlo(听书)、dle(电子书)
笔记ebook notes -i <ebookID>、dle <id> -t 4
学习圈channel info、homepage、vip --id <channelID>
学习记录/VIPrecent、vip-ebook、vip-odob
维护clean output、clean cache、web(Web UI,默认 127.0.0.1:17878)

完整参考

注意事项

  • 排查前先复述用户目标(看列表/详情/下载/笔记/报错),再给最短可执行命令,之后才补可选参数
  • PDF 批量转换可能触发频率限制(如 496),降低并发重试
  • 部分内容需要购买或 VIP 权限,报权限类错误先确认账号资产
  • web 命令会常驻进程(默认 127.0.0.1:17878,--open=false 不自动开浏览器);在无人值守/用户无终端的环境里,用完要主动结束该进程

© yann0917, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/dedao-dl of yann0917/dedao-dl.

  • SKILL.md
  • references/commands.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 2eee88b

Compare with similar skills

dedao-dl Download Assistant next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

dedao-dl Download Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
dedao-dl Download Assistant this skillyann0917/dedao-dl896—~924Automated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Gzh Designisjiamu/gzh-design-skill4k—~2.2kAutomated safety check: PassAGPL-3.0
Bookforge Korean Ebook PDF Makergongnyang/bookforge3161 repos~1.7kAutomated safety check: PassMIT
Huashu Markdown Publishing Pipelinealchaincyf/huashu-md-html910—~4.8kAutomated safety check: PassMIT
Lov Any2pdflovstudio/any2pdf211—~2.4kAutomated safety check: NotesMIT

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    4k GitHub stars~2.2k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Produces book-style Korean ebook PDFs from a topic or finished manuscript, with six design styles, real book parts and quality-check gates before output.

    316 GitHub starsUsed in 1 repo~1.7k tokens
    Documents & OfficeAuto-check passed
  • Huashu Markdown Publishing Pipeline

    alchaincyf/huashu-md-html

    Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.

    910 GitHub stars~4.8k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Lov Any2pdf

    lovstudio/any2pdf

    Convert Markdown documents to professionally typeset PDF files with reportlab.

    211 GitHub stars~2.4k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Documents & OfficeAuto-check passed

Works with

Questions about dedao-dl Download Assistant

What does dedao-dl Download Assistant do?

Operates the dedao-dl command-line downloader for Dedao courses, audiobooks and ebooks, with login, search, download formats and troubleshooting. cn). It downloads purchased courses and the daily audiobook as MP3, PDF or Markdown, and ebooks as HTML, PDF, EPUB or reading notes.

When should I use dedao-dl Download Assistant?

dedao-dl Download Assistant fits situations like: downloading a purchased Dedao course as MP3, PDF or Markdown; exporting an ebook or reading notes from Dedao; downloading content from a pasted dedao.cn link; switching between several Dedao accounts.

How do I install dedao-dl Download Assistant in Claude Code?

Run `npx skills add yann0917/dedao-dl --skill dedao-dl -a claude-code`. Or copy the skill folder (skills/dedao-dl in yann0917/dedao-dl) into .claude/skills/dedao-dl in your project. Claude Code loads it when a task matches its description.

How do I install dedao-dl Download Assistant in Codex?

Run `npx skills add yann0917/dedao-dl --skill dedao-dl -a codex`. Or copy the skill folder (skills/dedao-dl in yann0917/dedao-dl) into .agents/skills/dedao-dl in your project. Codex loads it when a task matches its description.

Can I use dedao-dl Download Assistant in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yann0917/dedao-dl --skill dedao-dl -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dedao-dl, .gemini/skills/dedao-dl, .github/skills/dedao-dl and .opencode/skills/dedao-dl in your project.

What does dedao-dl Download Assistant need to run?

SKILL.md names no scripts, command-line tools or credentials: dedao-dl Download Assistant is instructions for the agent only. Our summary lists: The dedao-dl command-line tool and a Dedao account; wkhtmltopdf for PDF export; ffmpeg for audio processing.

Does dedao-dl Download Assistant access the network?

SKILL.md names 1 domain. In commands or code: dedao.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is dedao-dl Download Assistant safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does dedao-dl Download Assistant use?

dedao-dl Download Assistant is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does dedao-dl Download Assistant use?

About 924 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to dedao-dl Download Assistant?

Skills that share tags, products or a category with dedao-dl Download Assistant: Markitdown (ImCa0/just-laws, 781 stars), Gzh Design (isjiamu/gzh-design-skill, 4k stars), Bookforge Korean Ebook PDF Maker (gongnyang/bookforge, 316 stars) and Huashu Markdown Publishing Pipeline (alchaincyf/huashu-md-html, 910 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains dedao-dl Download Assistant?

yann0917 (a GitHub user) maintains it in yann0917/dedao-dl, which has 896 GitHub stars. The repository was last updated on October 10, 2026.

Source: yann0917/dedao-dl on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.