todo

v2026.09.24

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.

GitHub
Install command
npx skhub add poteto/todo
Markdown
SKILL.md

Todo

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

File Format

# 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.
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

.agents/skills/todo

Default branch

main

Latest commit

82d2921

Tree SHA

9fccb6b