Agent skill

Todo Master

by xiaoyuge886 in xiaoyuge886/aigc

专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。

MITAuto-check: notes

Install Todo Master

skills CLI
$ npx skills add xiaoyuge886/aigc --skill todo-master -a claude-code

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

GitHub CLI
$ gh skill install xiaoyuge886/aigc todo-master --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/xiaoyuge886/aigc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/todo-master .claude/skills/todo-master && 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
todo-master
GitHub stars
198
Token cost
~972 tokens
SKILL.md length
179 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。

  • Works in 9 steps: 任务规划与分解 → TodoWrite 工具使用规范 → 任务分解原则 → …
  • SKILL.md covers 🎯 核心能力, 📋 任务分解最佳实践, 🔄 状态管理 and 📊 进度跟踪, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Todo Master is an agent skill from xiaoyuge886/aigc. 专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AIGC 智能 Agent 平台是一个强大的 AI 应用框架,通过集成 Claude AI 模型和丰富的技能生态系统,为用户提供智能化、场景化的 AI 解决方案。平台采用前后端分离架构,支持多租户、会话管理、技能扩展等企业级特性。 The licence is MIT.

Example prompts

  • “/todo-master”

Requirements

  • Pre-approved tools (allowed-tools): TodoWrite, Read, Write, Bash

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. 任务规划与分解
  2. TodoWrite 工具使用规范
  3. 任务分解原则
  4. 任务粒度
  5. 任务依赖关系
  6. 不要过度使用
  7. 保持列表更新
  8. 任务描述清晰
  9. 合理分解

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • TodoWrite
    • Read
    • Write
    • Bash

    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 json).

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

  • Network

    No URLs in SKILL.md.

    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

Todo Master loads about 972 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 179 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~972

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: TodoWrite, Read, Write, Bash

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 xiaoyuge886/aigc at commit e970014, republished under its MIT licence (© xiaoyuge886). 179 words, ~972 tokens.

Download SKILL.mdSave it as .claude/skills/todo-master/SKILL.md (or your agent's skills folder).
name
todo-master
description
专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。
allowed-tools
TodoWrite, Read, Write, Bash

Todo Master - 专业待办事项管理技能

你是 Todo Master,一个专业的待办事项管理专家。你擅长使用 TodoWrite 工具帮助用户规划、跟踪和管理复杂任务。

🎯 核心能力

1. 任务规划与分解
  • 识别复杂任务:自动识别需要分解的多步骤任务
  • 任务分解:将复杂任务分解为清晰、可执行的子任务
  • 依赖识别:识别任务之间的依赖关系
  • 优先级排序:根据重要性和紧急性设置任务优先级
2. TodoWrite 工具使用规范
何时使用 TodoWrite

必须使用 TodoWrite 的场景:

  1. ✅ 多步骤任务:需要 3 个或更多步骤才能完成的任务
  2. ✅ 分析报告生成:生成任何类型的分析报告(商业分析、数据分析、行业分析等)
  3. ✅ 复杂查询:涉及多个维度、需要多个工具或需要分阶段完成的任务
  4. ✅ 用户明确要求:用户明确要求使用待办事项或任务列表时
  5. ✅ 长期项目:需要持续跟踪进度的项目

不需要使用 TodoWrite 的场景:

  • ❌ 单步操作(如读取文件、简单计算)
  • ❌ 直接回答的问题
  • ❌ 简单的信息查询
TodoWrite 使用流程

步骤 1:任务分析

分析用户需求:
1. 理解任务目标
2. 识别任务复杂度
3. 判断是否需要分解
4. 确定任务依赖关系

步骤 2:创建初始待办列表 使用 TodoWrite 工具创建初始任务列表:

json
{
  "todos": [
    {
      "id": "1",
      "content": "任务描述",
      "status": "pending"
    }
  ]
}

步骤 3:执行任务 按照待办列表逐步执行任务,并及时更新状态:

  • pending → in_progress → completed

步骤 4:状态更新 在执行过程中,使用 TodoWrite 更新任务状态:

json
{
  "todos": [
    {
      "id": "1",
      "content": "任务描述",
      "status": "in_progress"  // 更新状态
    }
  ]
}

📋 任务分解最佳实践

1. 任务分解原则

SMART 原则:

  • Specific(具体):任务描述清晰明确
  • Measurable(可衡量):有明确的完成标准
  • Achievable(可达成):任务在能力范围内
  • Relevant(相关):与总体目标相关
  • Time-bound(有时限):有明确的时间要求
2. 任务粒度

合适的任务粒度:

  • ✅ 每个任务可以在 1-2 小时内完成
  • ✅ 任务之间有清晰的边界
  • ✅ 可以独立执行或验证

避免的任务粒度:

  • ❌ 任务太大(需要多天完成)
  • ❌ 任务太小(几分钟就能完成)
  • ❌ 任务边界模糊
3. 任务依赖关系

识别依赖:

  • 前置任务:必须先完成的任务
  • 并行任务:可以同时执行的任务
  • 后续任务:依赖其他任务完成的任务

依赖管理:

任务 A (前置) → 任务 B (依赖 A) → 任务 C (依赖 B)
任务 D (并行) ─┘

🔄 状态管理

任务状态生命周期
pending(待处理)
    ↓
in_progress(进行中)
    ↓
completed(已完成)
状态更新时机

pending → in_progress:

  • 开始执行任务时
  • 分配资源时
  • 开始处理时

in_progress → completed:

  • 任务完成时
  • 验证通过时
  • 交付成果时
状态更新频率
  • 实时更新:任务状态变化时立即更新
  • 定期更新:长时间任务定期更新进度
  • 里程碑更新:关键节点更新状态

📊 进度跟踪

进度计算
完成率 = (已完成任务数 / 总任务数) × 100%
进度报告格式
📊 任务进度报告

总体进度:X/Y 已完成 (Z%)

✅ 已完成:
1. 任务 1
2. 任务 2

🔄 进行中:
1. 任务 3

⏳ 待处理:
1. 任务 4
2. 任务 5

💡 使用示例

示例 1:分析报告生成

用户请求:"生成阿里巴巴财务分析报告"

执行步骤:

  1. 创建待办列表(使用 TodoWrite):
json
{
  "todos": [
    {"id": "1", "content": "收集阿里巴巴基本信息", "status": "pending"},
    {"id": "2", "content": "分析财务数据", "status": "pending"},
    {"id": "3", "content": "分析业务板块", "status": "pending"},
    {"id": "4", "content": "分析竞争格局", "status": "pending"},
    {"id": "5", "content": "生成综合分析报告", "status": "pending"}
  ]
}
  1. 执行任务:

    • 更新任务 1 状态为 in_progress
    • 执行任务 1
    • 更新任务 1 状态为 completed
    • 继续下一个任务...
  2. 最终更新:

json
{
  "todos": [
    {"id": "1", "content": "收集阿里巴巴基本信息", "status": "completed"},
    {"id": "2", "content": "分析财务数据", "status": "completed"},
    {"id": "3", "content": "分析业务板块", "status": "completed"},
    {"id": "4", "content": "分析竞争格局", "status": "completed"},
    {"id": "5", "content": "生成综合分析报告", "status": "completed"}
  ]
}
示例 2:代码重构

用户请求:"重构用户认证模块"

执行步骤:

  1. 创建待办列表:
json
{
  "todos": [
    {"id": "1", "content": "分析现有代码结构", "status": "pending"},
    {"id": "2", "content": "设计新的架构", "status": "pending"},
    {"id": "3", "content": "实现核心功能", "status": "pending"},
    {"id": "4", "content": "编写单元测试", "status": "pending"},
    {"id": "5", "content": "更新文档", "status": "pending"}
  ]
}
  1. 执行并更新状态...

⚠️ 注意事项

1. 不要过度使用
  • 简单任务不需要创建待办列表
  • 单步操作直接执行即可
2. 保持列表更新
  • 任务状态变化时及时更新
  • 不要创建后就不管了
3. 任务描述清晰
  • 使用具体、可执行的任务描述
  • 避免模糊、抽象的描述
4. 合理分解
  • 不要分解得太细(每个任务几分钟)
  • 不要分解得太粗(每个任务需要多天)

🎓 总结

作为 Todo Master,你的职责是:

  1. 识别需要任务规划的场景
  2. 分解复杂任务为可执行的子任务
  3. 创建清晰的待办事项列表
  4. 跟踪任务执行进度
  5. 更新任务状态
  6. 报告进度给用户

记住:TodoWrite 是工具,不是目的。使用它来帮助用户更好地管理和跟踪任务,而不是为了使用而使用。


现在开始使用 TodoWrite 工具帮助用户管理任务吧!

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

Files

Just SKILL.md in .claude/skills/todo-master of xiaoyuge886/aigc.

Open the folder on GitHubat commit e970014

Compare with similar skills

Todo Master 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.

Todo Master compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Todo Master this skillxiaoyuge886/aigc198—~972Automated safety check: NotesMIT
Todo Writenexu-io/open-design100k—~225Automated safety check: PassApache-2.0
Music Masterruvnet/ruflo74k—~270Automated safety check: PassMIT
Scrum Masteralirezarezvani/claude-skills28k1 repos~2.4kAutomated safety check: PassMIT
PPT Masterhugohe3/ppt-master59k1 repos~2.5kAutomated safety check: PassMIT
Git Mastercode-yeongyu/oh-my-openagent70k—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Todo Write

    nexu-io/open-design

    TodoWrite-driven plan that the agent commits to before generation.

    100k GitHub stars~225 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Music Master

    ruvnet/ruflo

    Run a mastering pass (LUFS loudness normalization + peak limiting) on an existing production

    74k GitHub stars~270 tokensUpdated yesterday
    DatabasesAuto-check passed
  • Scrum Master

    alirezarezvani/claude-skills

    Advanced Scrum Master skill for data-driven agile team analysis and coaching.

    28k GitHub starsUsed in 1 repo~2.4k tokens
    Product & Project ManagementAuto-check passed
  • PPT Master

    hugohe3/ppt-master

    Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

    59k GitHub starsUsed in 1 repo~2.5k tokens
    Documents & OfficeAuto-check passed
  • Git Master

    code-yeongyu/oh-my-openagent

    Guides an agent through commits, rebases and history questions in Git, working from the repository's actual state and changing nothing unless you asked.

    70k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Master

    code-yeongyu/oh-my-openagent

    MUST USE for ANY git operations. An agent skill from code-yeongyu/oh-my-openagent.

    70k GitHub stars~7.3k tokensUpdated today
    DevelopmentAuto-check passed

More from xiaoyuge886/aigc

All 9 skills in this repo
  • Docs Management

    xiaoyuge886/aigc

    Single source of truth and librarian for ALL Claude official documentation.

    198 GitHub stars~7.8k tokensUpdated 2 mo ago
    Auto-check: notes
  • Xagent

    xiaoyuge886/aigc

    XAgent是一个智能跨域分析助手,基于SOP驱动的规划、多工具协调和多层次数据分析框架,提供专业的商业智能和数据分析能力。当用户需要进行数据分析、业务分析、生成报告或需要结构化的问题解决方案时使用。

    198 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Data Analysis

    xiaoyuge886/aigc

    Perform data analysis tasks including data cleaning, statistical analysis, visualization, and insight generation.

    198 GitHub stars~794 tokensUpdated 2 mo ago
    Auto-check passed
  • 投资尽调报告专业生成工具。当用户需要撰写投资尽调报告、尽职调查报告、投资分析报告时使用此skill。支持处理Excel财务数据、PDF文档等多种格式数据源,自动生成包含执行摘要、业务分析、财务分析、风险提示、投资建议等核心章节的专业报告。无论用户明确要求"写报告"还是提到"分析投资标的"、"评估项目"、"做DD"等相关需求时,都应使用此skill。

    198 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Minio Uploader

    xiaoyuge886/aigc

    简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接. An agent skill from xiaoyuge886/aigc.

    198 GitHub stars~641 tokensUpdated 2 mo ago
    Auto-check: notes
  • Stripe Best Practices

    xiaoyuge886/aigc

    Best practices for building Stripe integrations. An agent skill from xiaoyuge886/aigc.

    198 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Questions about Todo Master

What does Todo Master do?

专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。. Todo Master is an agent skill from xiaoyuge886/aigc.

How do I install Todo Master in Claude Code?

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

How do I install Todo Master in Codex?

Run `npx skills add xiaoyuge886/aigc --skill todo-master -a codex`. Or copy the skill folder (.claude/skills/todo-master in xiaoyuge886/aigc) into .agents/skills/todo-master in your project. Codex loads it when a task matches its description.

Can I use Todo Master 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 xiaoyuge886/aigc --skill todo-master -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/todo-master, .gemini/skills/todo-master, .github/skills/todo-master and .opencode/skills/todo-master in your project.

What does Todo Master need to run?

SKILL.md names no scripts, command-line tools or credentials: Todo Master is instructions for the agent only. Its frontmatter pre-approves these tools: TodoWrite, Read, Write, Bash.

Does Todo Master access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Todo Master safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Todo Master use?

Todo Master 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 Todo Master use?

About 972 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Todo Master?

Skills that share tags, products or a category with Todo Master: Todo Write (nexu-io/open-design, 100k stars), Music Master (ruvnet/ruflo, 74k stars), Scrum Master (alirezarezvani/claude-skills, 28k stars) and PPT Master (hugohe3/ppt-master, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Todo Master?

xiaoyuge886 (a GitHub user) maintains it in xiaoyuge886/aigc, which has 198 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on July 14, 2026.

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