Task planning skill that creates and manages task plans in markdown files. Tracks progress through a structured plan file, ensuring tasks are completed systematically before marking as done.
A task planning skill that helps you manage complex tasks through structured plan files.
This skill creates and maintains a PLAN.md file that tracks:
When starting a complex task, create a plan:
/plan create "Implement user authentication"
The skill will:
PLAN.md file with task breakdownCommon action examples:
# Create a plan
/plan create "Implement user authentication"
# Update subtask #0 to completed=true
/plan update 0 true
# Check plan status
/plan status
# Mark plan complete (only when all subtasks are done)
/plan complete
# Task: [Task Description]
## Status: in_progress | completed | blocked
## Subtasks
- [ ] Subtask 1 description
- [x] Subtask 2 description (completed)
- [ ] Subtask 3 description
## Notes
Any relevant notes or context.
Before any file write, checks if the operation aligns with the current plan.
After each tool use, updates plan progress if relevant.
Before stopping, verifies all planned subtasks are complete. If incomplete tasks remain, prompts to continue or explicitly acknowledge incomplete work.
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": ["create", "update", "complete", "status"],
"default": "create",
"description": "Action to perform on the plan"
},
"task": {
"type": "string",
"description": "Task description (for create action)"
},
"subtasks": {
"type": "array",
"items": { "type": "string" },
"description": "Optional subtask list (for create action)"
},
"subtask_index": {
"type": "integer",
"minimum": 0,
"description": "Subtask index to update (for update action)"
},
"completed": {
"type": "boolean",
"default": true,
"description": "Whether the target subtask is completed (for update action)"
}
},
"required": ["action"]
}
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"plan_path": {
"type": "string",
"description": "Path to the plan file"
},
"status": {
"type": "string",
"description": "Current plan status"
},
"progress": {
"type": "object",
"properties": {
"total": { "type": "integer" },
"completed": { "type": "integer" },
"percentage": { "type": "number" }
}
},
"message": {
"type": "string"
}
}
}