Agent skill

Todo Finder

by huangruiteng in huangruiteng/CS-Notes

“从 todos.json 和归档中以多种匹配方式查找 todo”

— description from SKILL.md by huangruiteng
MITAuto-check passed

Install Todo Finder

skills CLI
$ npx skills add huangruiteng/CS-Notes --skill todo-finder -a claude-code

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

GitHub CLI
$ gh skill install huangruiteng/CS-Notes todo-finder --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/huangruiteng/CS-Notes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.trae/openclaw-skills/todo-finder .claude/skills/todo-finder && 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-finder
GitHub stars
4k
Token cost
~272 tokens
SKILL.md length
55 words
Files
2 (incl. scripts)
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 3 steps: 准备查找条件(ID、标题、关键词等) → 运行脚本 python scripts/todo_finder.py "" → 脚本将返回查找结果
  • SKILL.md covers 适用场景, 使用步骤, 匹配方式 and 输出格式, plus 1 more section
  • Runs Python scripts from its folder; calls python

About this skill

Todo Finder is a skill in huangruiteng/CS-Notes (4k stars). Its SKILL.md is about 272 tokens, with 1 other file in the folder (scripts). Licence: MIT.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 准备查找条件(ID、标题、关键词等)
  2. 运行脚本 python scripts/todo_finder.py ""
  3. 脚本将返回查找结果

What it can do on your machine

Read from SKILL.md and the folder at commit f7b4e92. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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 Finder loads about 272 tokens when it runs. Until then it costs about 11 tokens; SKILL.md has 55 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from huangruiteng/CS-Notes at commit f7b4e92, republished under its MIT licence (© huangruiteng). 55 words, ~272 tokens.

Download SKILL.mdSave it as .claude/skills/todo-finder/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
todo-finder
description
从 todos.json 和归档中以多种匹配方式查找 todo

Todo Finder

适用场景

当需要查找 todo 时使用该技能。支持从 todos.json 和归档中以多种匹配方式查找 todo。

使用步骤

  1. 准备查找条件(ID、标题、关键词等)
  2. 运行脚本 python scripts/todo_finder.py "<query>"
  3. 脚本将返回查找结果

匹配方式

  • --id <todo_id> - 按 todo ID 精确匹配
  • --title <keyword> - 按标题关键词匹配
  • --keyword <keyword> - 按关键词匹配(标题、内容、链接等)
  • --status <status> - 按状态匹配(pending/in-progress/completed)
  • --priority <priority> - 按优先级匹配(P0-P9)
  • --assignee <assignee> - 按负责人匹配
  • --archived - 只查找归档中的 todo
  • --all - 查找所有 todo(包括归档)

输出格式

  • 列表格式:显示 todo ID、标题、状态、优先级
  • 详情格式:显示 todo 的完整信息

示例

bash
# 按 todo ID 精确匹配
python scripts/todo_finder.py --id todo-20260220-008

# 按标题关键词匹配
python scripts/todo_finder.py --title "Top Lean AI"

# 按关键词匹配
python scripts/todo_finder.py --keyword "调研"

# 按状态匹配
python scripts/todo_finder.py --status in-progress

# 按优先级匹配
python scripts/todo_finder.py --priority P2

# 查找归档中的 todo
python scripts/todo_finder.py --archived --keyword "调研"

# 查找所有 todo(包括归档)
python scripts/todo_finder.py --all --keyword "调研"

© huangruiteng, 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 1 other file (scripts) in .trae/openclaw-skills/todo-finder of huangruiteng/CS-Notes.

  • SKILL.md
  • scripts/todo_finder.py

Open the folder on GitHubat commit f7b4e92

Compare with similar skills

Todo Finder 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 Finder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Todo Finder this skillhuangruiteng/CS-Notes4k—~272Automated safety check: PassMIT
Todo Writenexu-io/open-design100k—~225Automated safety check: PassApache-2.0
Sponsor Findergithub/awesome-copilot40k1 repos~3kAutomated safety check: PassMIT
Dingtalk TodoDingTalk-Real-AI/dingtalk-workspace-cli3.2k—~1.9kAutomated safety check: PassApache-2.0
Flutter PR Checks Finderflutter/flutter180k—~1.3kAutomated safety check: PassBSD-3-Clause
Todopoteto/noodle454—~382Automated safety check: PassMIT

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
  • Sponsor Finder

    github/awesome-copilot

    Official

    Find which of a GitHub repository's dependencies are sponsorable via GitHub Sponsors.

    40k GitHub starsUsed in 1 repo~3k tokens
    Productivity & AutomationAuto-check passed
  • Dingtalk Todo

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉待办 / TODO。Use when 用户说 创建待办/TODO/任务提醒/指派任务/标记完成/查待办/紧急待办/循环待办/批量建待办/逾期待办。不做日报周报(走 dingtalk-misc)、审批(走 dingtalk-misc)、日程(走 dingtalk-calendar)。命令前缀:dws todo。

    3.2k GitHub stars~1.9k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Find failing checks on a Flutter PR and locate the corresponding LUCI log URLs.

    180k GitHub stars~1.3k tokensUpdated today
    MobileAuto-check passed
  • Todo

    poteto/noodle

    Add, complete, or view items in the brain/todos.md backlog. An agent skill from poteto/noodle.

    454 GitHub stars~382 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Todos

    JetBrains/thinkrail

    Official

    A skill your agent uses when the user asks for a shared plan, a task needs at least three substantive execution steps, or a loose TODO is pending.

    514 GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed

More from huangruiteng/CS-Notes

All 39 skills in this repo
  • CLI Creator

    huangruiteng/CS-Notes

    Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script.

    4k GitHub starsUsed in 2 repos~2.7k tokens
    Auto-check passed
  • Codex Thread Heartbeat

    huangruiteng/CS-Notes

    Inspect and manage guarded Codex App-native or launchd heartbeats for Codex main control threads.

    4k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Slack

    huangruiteng/CS-Notes

    A skill your agent uses when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.

    4k GitHub starsUsed in 10 repos~578 tokens
    Auto-check passed
  • Codex Thread Reader

    huangruiteng/CS-Notes

    Locate and read a Codex thread by a codex thread link, thread id, or rollout path across all local CODEXHOME directories (~/.codex, ~/.codex-gpt, ...).

    4k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Research Material Scout

    huangruiteng/CS-Notes

    A skill your agent uses when the user asks Codex to research, find learning materials, process "素材:" links, "请你读" / "精读" a material, build a material radar, or use SenSight-like broad information…

    4k GitHub stars~8.3k tokensUpdated 2 days ago
    Auto-check passed
  • GitHub

    huangruiteng/CS-Notes

    Interact with GitHub using the gh CLI. An agent skill from huangruiteng/CS-Notes.

    4k GitHub starsUsed in 27 repos~279 tokens
    Auto-check passed

Questions about Todo Finder

How do I install Todo Finder in Claude Code?

Run `npx skills add huangruiteng/CS-Notes --skill todo-finder -a claude-code`. Or copy the skill folder (.trae/openclaw-skills/todo-finder in huangruiteng/CS-Notes) into .claude/skills/todo-finder in your project. Claude Code loads it when a task matches its description.

How do I install Todo Finder in Codex?

Run `npx skills add huangruiteng/CS-Notes --skill todo-finder -a codex`. Or copy the skill folder (.trae/openclaw-skills/todo-finder in huangruiteng/CS-Notes) into .agents/skills/todo-finder in your project. Codex loads it when a task matches its description.

Can I use Todo Finder 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 huangruiteng/CS-Notes --skill todo-finder -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-finder, .gemini/skills/todo-finder, .github/skills/todo-finder and .opencode/skills/todo-finder in your project.

What does Todo Finder need to run?

Going by SKILL.md and its folder, Todo Finder needs Python for the scripts in its folder and the command-line tools its instructions call (python).

Does Todo Finder 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 Finder 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Todo Finder use?

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

About 272 tokens (SKILL.md is roughly 1.1k 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 Finder?

Skills that share tags, products or a category with Todo Finder: Todo Write (nexu-io/open-design, 100k stars), Sponsor Finder (github/awesome-copilot, 40k stars), Dingtalk Todo (DingTalk-Real-AI/dingtalk-workspace-cli, 3.2k stars) and Flutter PR Checks Finder (flutter/flutter, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Todo Finder?

huangruiteng (a GitHub user) maintains it in huangruiteng/CS-Notes, which has 4,001 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 8, 2026.

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