Agent skill

Todo

by poteto in poteto/noodle

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

MITAuto-check passedAgent Workflows

Install Todo

skills CLI
$ npx skills add poteto/noodle --skill todo -a claude-code

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

GitHub CLI
$ gh skill install poteto/noodle todo --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/poteto/noodle.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/todo .claude/skills/todo && 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
GitHub stars
437
Token cost
~382 tokens
SKILL.md length
132 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 3 steps: Read <!-- next-id: N --> to get the next… → Append N. [ ] description to the target… → Increment the next-id marker: <!--…
  • The user says todo
  • SKILL.md covers File Format, Operations and Rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Todo is an agent skill from poteto/noodle. Add, complete, or view items in the brain/todos.md backlog. Use when the user says "todo", "add a todo", "mark done", "what's on the backlog", "show todos", "list tasks", "check off", or wants to manage their task list.

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

It sits in Agent Workflows, covering Task breakdown. The repository describes itself as: Orchestrate agents using skills. The licence is MIT.

When your agent uses it

  • The user says todo
  • Whats on the backlog
  • Wants to manage their task list

Example prompts

  • “add a todo”
  • “mark done”
  • “s on the backlog”
  • “/todo”

Workflow steps

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

  1. Read <!-- next-id: N --> to get the next ID
  2. Append N. [ ] description to the target section
  3. Increment the next-id marker: <!-- next-id: N+1 -->

What it can do on your machine

Read from SKILL.md and the folder at commit 82d2921. 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 loads about 382 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 132 words of instructions outside code blocks.

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

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 poteto/noodle at commit 82d2921, republished under its MIT licence (© poteto). 132 words, ~382 tokens.

Download SKILL.mdSave it as .claude/skills/todo/SKILL.md (or your agent's skills folder).
name
todo
description
Add, complete, or view items in the brain/todos.md backlog. Use when the user says "todo", "add a todo", "mark done", "what's on the backlog", "show todos", "list tasks", "check off", or wants to manage their task list.

Todo

Manage the project backlog at brain/todos.md. Edit the file directly with Edit/Write tools.

File Format

markdown
# Todos

<!-- next-id: 26 -->

## Section Name

1. [x] Completed item description
2. [ ] Open item description [[plans/02-some-plan/overview]]
  • Items are numbered markdown checkboxes: N. [ ] description or N. [x] description
  • Sections are ## Heading groups
  • <!-- next-id: N --> tracks the next available ID

Operations

Add an item
  1. Read <!-- next-id: N --> to get the next ID
  2. Append N. [ ] description to the target section
  3. Increment the next-id marker: <!-- next-id: N+1 -->
Mark done

Change [ ] to [x] and update the description with a reason:

2. [x] Old description — superseded by #75 channel UI redesign

Then move the done item from brain/todos.md to brain/archive/todos.md (create the file if it doesn't exist). Remove empty sections left behind.

Edit description

Replace the description text. Preserve any [[wikilinks]] unless intentionally removing them.

Rules

  • IDs are permanent. Never renumber or reuse them.
  • Always increment <!-- next-id --> when adding items.
  • Keep items in their section — don't move between sections without being asked.

© poteto, 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 of poteto/noodle.

Open the folder on GitHubat commit 82d2921

Compare with similar skills

Todo 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Todo this skillpoteto/noodle437—~382Automated safety check: PassMIT
MemPalace Task HandoffMemPalace/mempalace59k—~1.9kAutomated safety check: PassMIT
Planning And Task Breakdownabashev/vfs-s31068 repos~1.9kAutomated safety check: PassApache-2.0
Incremental Implementationaddyosmani/agent-skills103k1 repos~2.3kAutomated safety check: PassMIT
ULW Plan Workflowcode-yeongyu/oh-my-openagent70k—~3.9kAutomated safety check: PassCustom licence
Implementation Plan Creatortailcallhq/forgecode7.6k1 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • MemPalace Task Handoff

    MemPalace/mempalace

    Creates, hands off, claims, executes and closes agent tasks through the MemPalace logstream, with approval of the exact task before it is recorded.

    59k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Breaks work into ordered tasks. An agent skill from abashev/vfs-s3.

    106 GitHub starsUsed in 8 repos~1.9k tokens
    Agent WorkflowsAuto-check passed
  • Incremental Implementation

    addyosmani/agent-skills

    Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.

    103k GitHub starsUsed in 1 repo~2.3k tokens
    Agent WorkflowsAuto-check passed
  • ULW Plan Workflow

    code-yeongyu/oh-my-openagent

    Explore-first planning that turns a vague or large request into one decision-complete work plan, written only after your approval and executed by a separate worker.

    70k GitHub stars~3.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Implementation Plan Creator

    tailcallhq/forgecode

    Writes a structured Markdown implementation plan with checkbox tasks, verification criteria and risks, then checks it with a validation script; no code changes.

    7.6k GitHub starsUsed in 1 repo~1.1k tokens
    Agent WorkflowsAuto-check passed
  • Runs a whole project unattended on an agtx kanban board, decomposing the goal, starting tasks, unblocking workers and merging each result.

    1.7k GitHub stars~3.8k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed

More from poteto/noodle

All 26 skills in this repo
  • Meditate

    poteto/noodle

    Audit and evolve the brain vault — prune outdated content, discover cross-cutting principles, review skills for structural encoding opportunities.

    437 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Ruminate

    poteto/noodle

    Mine past Claude Code and Codex conversations for uncaptured patterns, corrections, and knowledge.

    437 GitHub stars~1.4k tokensUpdated 6 mo ago
    Auto-check passed
  • Ast Grep

    poteto/noodle

    Structural code search via ast-grep — use when code shape and element relationships matter, not just text.

    437 GitHub stars~531 tokensUpdated 6 mo ago
    Auto-check passed
  • Execute

    poteto/noodle

    Implementation methodology for executing tasks. An agent skill from poteto/noodle.

    437 GitHub stars~989 tokensUpdated 6 mo ago
    Auto-check passed
  • Noodle

    poteto/noodle

    Operate the Noodle CLI — explain commands, find flags, create/edit .noodle.toml config.

    437 GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Plan

    poteto/noodle

    Systematic planning for medium-to-large tasks. An agent skill from poteto/noodle.

    437 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Todo

What does Todo do?

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

When should I use Todo?

Todo fits situations like: the user says todo; whats on the backlog; wants to manage their task list.

How do I install Todo in Claude Code?

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

How do I install Todo in Codex?

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

Can I use Todo 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 poteto/noodle --skill todo -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, .gemini/skills/todo, .github/skills/todo and .opencode/skills/todo in your project.

What does Todo need to run?

SKILL.md names no scripts, command-line tools or credentials: Todo is instructions for the agent only.

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

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

About 382 tokens (SKILL.md is roughly 1.5k 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?

Skills that share tags, products or a category with Todo: MemPalace Task Handoff (MemPalace/mempalace, 59k stars), Planning And Task Breakdown (abashev/vfs-s3, 106 stars), Incremental Implementation (addyosmani/agent-skills, 103k stars) and ULW Plan Workflow (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Todo?

poteto (a GitHub user) maintains it in poteto/noodle, which has 437 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on March 19, 2026.

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