← Back to Skills Marketplace
angjustinl

得到 Skill

by ANGJustinl · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
329
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install dedao-dl-skill
Description
Handles interactions with the dedao-dl CLI tool for downloading and managing content from the Dedao (得到) App. Use when the user wants to list bought courses,...
README (SKILL.md)

dedao-dl

This skill guides the agent in using the dedao-dl CLI tool to interact with the Dedao (得到) app content.

Initialization

MANDATORY FIRST STEP: Before using any dedao-dl commands for the first time, you MUST run the installation script and verify the CLI is available.

Run the script to download the latest binary for the current OS:

python scripts/install_dedao_dl.py

After installation, you should ALWAYS use the helper script scripts/run_dedao.py to execute commands instead of running the raw dedao-dl executable. The helper script cleans up the CLI's terminal formatting, making the output directly readable by you without needing to redirect it to text files. Example: Use python scripts/run_dedao.py -h instead of ./dedao-dl -h.

Prerequisites & Login

Before downloading any content, ensure the user is logged in:

  • Command: python scripts/run_dedao.py login -q (QR code login) or python scripts/run_dedao.py login -c "\x3Ccookie_string>"
  • Verify current user: python scripts/run_dedao.py who
  • List logged-in users: python scripts/run_dedao.py users
  • Switch user: python scripts/run_dedao.py su

Dependencies for specific formats (inform the user if they are missing):

  • PDF generation requires wkhtmltopdf
  • Audio generation requires ffmpeg
  • Markdown requires no additional dependencies

General Workflow

For any content download, the typical two-step workflow is:

  1. List the specific type of content to find its ID.
  2. Use the corresponding download command with the ID and format flag (-t).

Key Workflows & Commands

1. Courses (专栏/课程) & Free Content (免费专区)

  • List purchased courses: python scripts/run_dedao.py course
  • List free courses: python scripts/run_dedao.py free (Returns EnID strings instead of integer IDs)
  • List articles in a course:
    • For purchased courses (using integer ID): python scripts/run_dedao.py course -i \x3Ccourse_ID>
    • For free courses (using EnID): python scripts/run_dedao.py article -c \x3Ccourse_EnID>
  • Download a single article (RECOMMENDED): python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID> -t \x3Cformat>
  • Download a full course: python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> -t \x3Cformat> [options]
    • WARNING: NEVER download a full course (only 1 parameter) without explicit user permission. Full downloads can take hours, consume massive disk space, and trigger anti-bot bans.
    • Formats (-t): 1 (MP3), 2 (PDF), 3 (Markdown, DEFAULT FOR THE AGENT)
    • Options for Markdown (-t 3): -m (merge into one file), -c (include hot comments)
    • Prefix ordering: -o (adds index prefix like 00x.) Note: When downloading as PDF, be aware of rate limits ("496 NoCertificate"). Add sleep intervals if scripting.

2. E-Books (电子书)

  • List e-books: python scripts/run_dedao.py ebook
  • Download an e-book: python scripts/run_dedao.py dle \x3Cebook_ID> -t \x3Cformat>
    • Formats (-t): 1 (HTML, default), 2 (PDF), 3 (EPUB), 4 (Markdown Notes)
  • View e-book notes: python scripts/run_dedao.py ebook notes -i \x3Cebook_ID>
  • Export e-book notes: python scripts/run_dedao.py dle \x3Cebook_ID> -t 4 (Downloads notes as Markdown)

3. Audiobooks (每天听本书)

  • List audiobooks: python scripts/run_dedao.py odob
  • Download audiobook audio/text: python scripts/run_dedao.py dlo \x3Caudiobook_ID> -t \x3Cformat>
    • Formats (-t): 1 (MP3), 2 (PDF), 3 (Markdown, DEFAULT FOR THE AGENT)

4. Other Content

  • List all categories & stats: python scripts/run_dedao.py cat
  • List 'JinNang' (锦囊): python scripts/run_dedao.py ace
  • List recommended topics (知识城邦): python scripts/run_dedao.py topic

Execution Guidelines

  • Always check python scripts/run_dedao.py -h or python scripts/run_dedao.py \x3Ccommand> -h if unsure of the exact arguments.
  • Always retrieve the correct ID first before executing a download command. Make sure you use the list command corresponding to the content type you want to download (e.g., course ID for dl, ebook ID for dle, odob ID for dlo). Do not mix up IDs across categories.
  • NEVER download an entire course (e.g. python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID>) unless the user explicitly asks you to. Many courses have hundreds of articles which can lead to account bans.
  • ALWAYS favor downloading a single article: First list the course articles using course -i \x3Ccourse_ID> or article -c \x3Ccourse_EnID>, find the specific article ID, and use python scripts/run_dedao.py dl \x3Ccourse_ID_or_EnID> \x3Carticle_ID>.
  • DEFAULT FORMAT: Whenever you download content using dl or dlo, default to using -t 3 (Markdown) unless the user explicitly asks for MP3 or PDF. Markdown is safer, faster, and easier to read.
  • When generating markdown for a whole course (if permitted by the user), consider using -m to consolidate files unless the user explicitly asks for individual files.
Usage Guidance
This skill is a coherent wrapper for the dedao-dl CLI, but you should: (1) verify you trust the upstream GitHub repository (yann0917/dedao-dl) before running the install script; (2) inspect the release asset and, if possible, download and verify checksums manually rather than relying on the script; (3) be cautious when supplying cookie strings or other credentials — prefer QR login or run commands interactively so secrets are not saved into logs; (4) run the installer and binary in a sandbox or isolated environment if you are unsure; and (5) remember downloading full courses may violate terms of service or copyright and can consume large disk space and bandwidth.
Capability Analysis
Type: OpenClaw Skill Name: dedao-dl-skill Version: 0.1.1 The skill bundle includes an installation script (scripts/install_dedao_dl.py) that automatically downloads and executes a remote binary from a GitHub repository (yann0917/dedao-dl). While this behavior is aligned with the stated purpose of providing the 'dedao-dl' CLI tool, the practice of fetching and running opaque binaries from the internet is a high-risk pattern that could facilitate supply chain attacks or arbitrary code execution if the remote repository is compromised.
Capability Assessment
Purpose & Capability
Name/description match the included scripts and instructions. The skill only requires downloading and running the dedao-dl binary and provides a helper wrapper to clean CLI output; nothing requested is outside that scope.
Instruction Scope
SKILL.md is focused on using the dedao-dl tool: installation, listing content, login, and download workflows. It does not instruct the agent to read unrelated files or exfiltrate data. It does instruct the user/agent to pass login cookies or use QR login, which is expected for this use case.
Install Mechanism
The provided install script fetches the latest release via the GitHub API for repo yann0917/dedao-dl and writes the release asset directly to a local executable name. Using GitHub releases is reasonable, but the script does not verify checksums or signatures and may pick an archive asset as a fallback (the code prefers direct binaries but can fall back to any asset). This increases risk if the upstream repo or its releases are compromised.
Credentials
The skill declares no required environment variables or credentials, which aligns with its purpose. However SKILL.md instructs providing authentication via QR or an explicit cookie string (login -c "<cookie_string>") — the agent or user will handle secrets at runtime. The skill itself does not request unrelated credentials.
Persistence & Privilege
The skill does not request always-on presence, does not modify other skills or system-wide configs, and only places files in the current directory (the downloaded binary). It runs binaries provided by the upstream project but does not persist credentials or alter agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install dedao-dl-skill
  3. After installation, invoke the skill by name or use /dedao-dl-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
No user-visible changes in this version (0.1.1); documentation and implementation remain the same.
v0.1.0
Initial release of dedao-dl-skill. - Provides clear workflows for downloading and managing Dedao App content via the dedao-dl CLI, covering courses, ebooks, audiobooks, and more. - Enforces mandatory installation and use of a helper script to ensure readable command outputs. - Details login procedures and format-specific dependencies. - Outlines safety guidelines to avoid excessive downloads and potential account bans. - Standardizes on Markdown format for downloads unless otherwise specified by the user.
Metadata
Slug dedao-dl-skill
Version 0.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is 得到 Skill?

Handles interactions with the dedao-dl CLI tool for downloading and managing content from the Dedao (得到) App. Use when the user wants to list bought courses,... It is an AI Agent Skill for Claude Code / OpenClaw, with 329 downloads so far.

How do I install 得到 Skill?

Run "/install dedao-dl-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 得到 Skill free?

Yes, 得到 Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 得到 Skill support?

得到 Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 得到 Skill?

It is built and maintained by ANGJustinl (@angjustinl); the current version is v0.1.1.

💬 Comments