Vercel Composition Patterns
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
“Todo 管理技能，用于管理架构演进过程中的待办事项”
Install Todo Manager
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install shenjingnan/xiaozhi-client todo-manager --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/todo-manager .claude/skills/todo-manager && rm -rf skills-srcUse ~/.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/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .claude/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-managerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install shenjingnan/xiaozhi-client todo-manager --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/todo-manager .agents/skills/todo-manager && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .agents/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install shenjingnan/xiaozhi-client todo-manager --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/todo-manager .cursor/skills/todo-manager && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .cursor/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/shenjingnan/xiaozhi-client.git --path .agents/skills/todo-manager--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install shenjingnan/xiaozhi-client todo-manager --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/todo-manager .gemini/skills/todo-manager && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .gemini/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install shenjingnan/xiaozhi-client todo-managerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/todo-manager .github/skills/todo-manager && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .github/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install shenjingnan/xiaozhi-client todo-manager --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/shenjingnan/xiaozhi-client.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/todo-manager .opencode/skills/todo-manager && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "todo-manager" agent skill from https://github.com/shenjingnan/xiaozhi-client/tree/main/.agents/skills/todo-manager into .opencode/skills/todo-manager/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "todo-manager", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
todo-manager- GitHub stars
- 341
- Token cost
- ~600 tokens
- SKILL.md length
- 140 words
- Files
- 1
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- MIT
At a glance
- Works in 12 steps: 创建 Todo 文档 → 查看所有 Todo → 搜索特定 Todo → …
- SKILL.md covers 为什么会有 Todo, 技能能力, 使用方法 and Todo 文档最佳实践, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
About this skill
Todo Manager is a skill in shenjingnan/xiaozhi-client (341 stars). Its SKILL.md is about 600 tokens. Licence: MIT.
Workflow steps
12 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit fe3c382. 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 markdown).
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 Manager loads about 600 tokens when it runs. Until then it costs about 10 tokens; SKILL.md has 140 words of instructions outside code blocks.
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 shenjingnan/xiaozhi-client at commit fe3c382, republished under its MIT licence (© shenjingnan). 140 words, ~600 tokens.
Download SKILL.mdSave it as
.claude/skills/todo-manager/SKILL.md (or your agent's skills folder).- name
- todo-manager
- description
- Todo 管理技能，用于管理架构演进过程中的待办事项
我是 Todo Manager，专门负责管理 xiaozhi-client 项目架构演进过程中的待办事项。
为什么会有 Todo
在软件架构演进过程中，新老架构共存是必然现象。我们无法在单个 PR 中完成所有改动，因此需要通过多个 PR 逐步迭代。这些跨 PR 的任务需要被妥善记录和管理。
Todo 存在的原因
- 架构迁移需要分阶段进行：新旧架构需要在一段时间内共存
- 向后兼容性要求：在完全迁移前，旧代码需要保留以保持兼容性
- 风险控制：大规模改动风险高，需要分步验证
- 团队协作：不同开发者可能负责不同阶段的任务
- 知识传递：待办事项文档是技术决策的载体
Todo vs Issue
| Todo 文档 | Issue |
|---|---|
| 存储在代码仓库中 | 存储在 GitHub 上 |
| 关注技术细节和实现方法 | 关注用户价值和功能需求 |
| 用于架构演进记录 | 用于功能跟踪和讨论 |
| 包含详细的技术上下文 | 通常是高层描述 |
技能能力
1. 创建 Todo 文档
通过 /todo <标题> 命令创建新的待办事项。
2. 查看所有 Todo
请列出 todos 目录下的所有待办事项，按创建时间排序3. 搜索特定 Todo
请搜索包含"连接管理"关键词的 todo 文档请搜索影响 src/server/services/ 目录的所有 todo4. 评估 Todo 优先级
请评估当前所有 todo 的处理优先级，考虑：
- 阻塞其他任务的程度
- 技术债务的严重性
- 处理的复杂度5. 检查 Todo 状态
请检查是否有 todo 的处理条件已满足（如相关 PR 已合并）使用方法
查看所有待办事项
请帮我列出 todos 目录下的所有待办事项，并简要说明每个 todo 的状态评估某个 Todo 是否可以处理
我正在处理端点迁移工作，请帮我检查有哪些 todo 现在可以处理了更新 Todo 文档
请更新 todos/2025-01-23-refactor-connection-manager.md，添加以下信息：
- 相关 PR #595 已合并
- 预计在下一个版本处理关闭已完成的 Todo
todos/2025-01-23-refactor-connection-manager.md 已完成，请将其归档或标记为已完成Todo 文档最佳实践
1. 清晰的背景说明
## 背景
在独立架构迁移（#590）中，我们需要逐步将各个端点从旧的负载均衡架构迁移到独立架构。这个 todo 涉及迁移最后一个端点。2. 明确的 Todo 原因
## 为什么 Todo
- 旧代码仍有其他模块依赖
- 需要等待所有端点迁移完成
- 当前阶段需要保持向后兼容3. 可判断的处理时机
## 合适的处理时机
- 所有端点都已迁移到独立架构
- 没有代码引用旧的 LoadBalancer 类
- 相关测试已更新4. 详细的处理方法
## 正确的处理方法
1. 确认没有代码引用 LoadBalancer
2. 删除 src/server/services/LoadBalancer.ts（如存在）
3. 更新相关导入语句
4. 运行 pnpm check:all 验证
5. 提交 PR 并关联此 todo5. 准确的影响范围
## 影响范围
- src/server/services/LoadBalancer.ts（删除）
- src/server/services/MCPServiceManager.ts（更新导入）
- 对应的测试文件（删除）验证检查清单
创建或更新 Todo 文档时，确保：
- 背景信息清晰完整
- Todo 原因明确具体
- 处理时机有明确的判断标准
- 处理方法详细可执行
- 影响范围准确列出
- 文件命名符合规范（YYYY-MM-DD-kebab-title.md）
- 包含创建时间和更新记录
最佳实践
1. 及时创建
发现需要跨 PR 处理的问题时，立即创建 todo 文档，不要依赖记忆。
2. 保持更新
当相关 PR 合并、代码变更或条件变化时，及时更新 todo 文档。
3. 精确定位
影响范围要精确到具体文件和行号，避免模糊描述。
4. 关联追踪
在 PR 描述中引用相关 todo，在 todo 中记录相关 PR 编号。
5. 定期回顾
在规划新任务时，先检查 todos 目录，看看是否有相关的待办事项可以一并处理。
6. 完成归档
todo 完成后，在文档中添加完成记录，可以考虑移至 todos/archived/ 目录。
© shenjingnan, 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 .agents/skills/todo-manager of shenjingnan/xiaozhi-client.
Open the folder on GitHubat commit fe3c382
Compare with similar skills
Todo Manager 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Todo Manager this skillshenjingnan/xiaozhi-client | 341 | — | ~600 | Automated safety check: Pass | MIT | |
| Vercel Composition Patternssupabase/supabase | 111k | 58 repos | ~726 | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Typescript Advanced Typesrolling-scopes/rsschool-app | 10k | 25 repos | ~4.2k | Automated safety check: Pass | MPL-2.0 | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 4 repos | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
- Official
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
Typescript Advanced Types
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
More from shenjingnan/xiaozhi-client
All 16 skills in this repoE2E Coverage Analyzer
shenjingnan/xiaozhi-client
分析当前分支 git 改动，检查 e2e 测试用例覆盖情况，并可补充缺失的测试用例. An agent skill from shenjingnan/xiaozhi-client.
Fix Comment
shenjingnan/xiaozhi-client
GitHub 评论修复技能，用于获取 PR 的 Copilot 评论并分析修复问题. An agent skill from shenjingnan/xiaozhi-client.
API Docs
shenjingnan/xiaozhi-client
文档自动生成
CI Validator
shenjingnan/xiaozhi-client
CI检查验证和质量保障
Commit
shenjingnan/xiaozhi-client
生成代码评审友好的 commit 信息
Dev Workflow Checker
shenjingnan/xiaozhi-client
开发流程检查技能，确保代码修改后执行必要的质量检查
Related
Categories
Questions about Todo Manager
How do I install Todo Manager in Claude Code?
Run `npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a claude-code`. Or copy the skill folder (.agents/skills/todo-manager in shenjingnan/xiaozhi-client) into .claude/skills/todo-manager in your project. Claude Code loads it when a task matches its description.
How do I install Todo Manager in Codex?
Run `npx skills add shenjingnan/xiaozhi-client --skill todo-manager -a codex`. Or copy the skill folder (.agents/skills/todo-manager in shenjingnan/xiaozhi-client) into .agents/skills/todo-manager in your project. Codex loads it when a task matches its description.
Can I use Todo Manager 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 shenjingnan/xiaozhi-client --skill todo-manager -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-manager, .gemini/skills/todo-manager, .github/skills/todo-manager and .opencode/skills/todo-manager in your project.
What does Todo Manager need to run?
SKILL.md names no scripts, command-line tools or credentials: Todo Manager is instructions for the agent only.
Does Todo Manager 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 Manager 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 Todo Manager use?
Todo Manager 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 Manager use?
About 600 tokens (SKILL.md is roughly 2.4k 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 Manager?
Skills that share tags, products or a category with Todo Manager: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Todo Manager?
shenjingnan (a GitHub user) maintains it in shenjingnan/xiaozhi-client, which has 341 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 3, 2026.
Source: shenjingnan/xiaozhi-client on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.