Todo

SkillProductivity

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Todo skill

What this skill tells your AI

The instructions your AI receives, as published by poteto/noodle in .agents/skills/todo/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
270
Forks
15
Last commit
Mar 2026
Advanced
Catalog kind
skill
Gateway key
todo-poteto
Source
github.com/poteto/noodle