Spool Tasks
Productivityspool-tasksSpool Tasks is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use Spool tasks CLI to manage tasks.md (status/next/start/complete/shelve/add).
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/workflow/spool-tasks/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/spool-tasks, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Use the spool tasks CLI to track and update implementation tasks for a change.
Rules
- Prefer
spool tasks ...over manual editing oftasks.md. - Enhanced tasks.md supports
start,shelve,unshelve, andadd. - Checkbox-only tasks.md is supported in compat mode (supports in-progress via
[~]/spool tasks start, but no shelving); start/complete tasks by 1-based index.
Common Commands
spool tasks status <change-id>
spool tasks next <change-id>
spool tasks ready # Show ready tasks across ALL changes
spool tasks ready <change-id> # Show ready tasks for a specific change
spool tasks ready --json # JSON output for automation
spool tasks start <change-id> <task-id>
spool tasks complete <change-id> <task-id>
spool tasks complete <change-id> <index>
spool tasks shelve <change-id> <task-id>
spool tasks unshelve <change-id> <task-id>
spool tasks add <change-id> "<task name>" --wave <n>
spool tasks show <change-id>
If tasks.md is missing
- Create enhanced tracking file:
spool tasks init <change-id>
If the user asks "what should I do next?"
- If working on a specific change: Run
spool tasks next <change-id> - If looking for any ready work: Run
spool tasks readyto see all actionable tasks - Follow the printed Action/Verify/Done When for the chosen task.
Guardrails
- If a task is blocked, run
spool tasks status <change-id>and either resolve blockers or shelve the task (enhanced only). - If
spool tasks shelvefails because the file is checkbox-only, explain that checkbox compat mode does not support shelving. - If
spool tasks startfails in compat mode, it is usually because the task id is not a 1-based index, or another task is already in-progress.