🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Todowrite
πŸ¦€ ClawHub

Todowrite

by @drumrobot

Route TODO checklists to the right storage. session - in-session tracking via /wip, file - persistent TODO (fix_plan.md, TODO.md), issue - team-shared via Gi...

Versionv0.3.0
Downloads719
#clawhub
TERMINAL
clawhub install todowrite

πŸ“– About This Skill

name: todowrite depends-on: [wip] description: Route TODO checklists to the right storage. session - in-session tracking via /wip, file - persistent TODO (fix_plan.md, TODO.md), issue - team-shared via GitHub Issues. "TODO management", "checklist", "todowrite", "fix_plan cleanup", "register as issue" triggers.

TodoWrite

Route TODO checklists to the appropriate storage based on context.

Routing Decision

New TODO arrives
  β”œβ”€ Only needed this session β†’ /wip (TaskCreate/TodoWrite)
  β”œβ”€ Persists beyond session β†’ file (fix_plan.md, TODO.md)
  └─ Team-shared β†’ issue (GitHub Issues)

Topics

| Topic | Storage | Lifetime | Tool | |-------|---------|----------|------| | session | TaskCreate/TodoWrite | Session | β†’ /wip skill | | file | fix_plan.md, TODO.md | While file exists | Write/Edit | | issue | GitHub Issues | Permanent | gh issue create |

Session β†’ /wip

Current session task tracking is handled by the wip skill:

/wip    # Track session work with TodoWrite/TaskCreate

File-based TODO

fix_plan.md (Ralph projects)

## Pending
  • [ ] Item 1 β€” description
    • 

  • [ ] Item 2 β€” description
    • Completed
  • [x] Done item β€” (completed: 2026-04-03, commit abc1234)
    •

    Rules:

  • Move to Completed section on completion + timestamp
  • Mark blocked items with [BLOCKED] tag
  • Mark skipped items with [SKIPPED] tag

    • TODO.md (General projects)

    # TODO
    High Priority
    

  • [ ] Urgent item
    • Normal
    

  • [ ] Regular item
    • Done
    

  • [x] Completed item (2026-04-03)
    •

    Issue-based TODO

    Team-shared TODOs go to GitHub Issues:

    # Create issue (user approval required)
gh issue create --title "Item" --body "Description"
    List issues
    
gh issue list --label "todo"

    Note: gh issue create only runs when user explicitly says "create an issue".

    Routing Examples

    | Situation | Route | Reason | |-----------|-------|--------| | "Run this 5-step deploy" | /wip (session) | Session tracking is sufficient | | "Fix this bug later" | file (fix_plan.md) | Persists beyond session | | "Assign this to Jinju" | issue (GitHub) | Team sharing needed | | "Note this from the review" | file (fix_plan.md) | Outside current PR scope |