diff --git a/task/SKILL.md b/task/SKILL.md new file mode 100644 index 0000000..ad3ca71 --- /dev/null +++ b/task/SKILL.md @@ -0,0 +1,44 @@ +--- +name: task +intent: plan, task, todo, steps, checklist, decompose, track +description: Guidance on using task_plan and task_complete to decompose goals and track progress. +--- + +# Task Planning + +Use `task_plan` to decompose a multi-step goal into an ordered checklist. Use `task_complete` to mark steps done as you finish them. + +## When to plan + +- The user asks you to do something with three or more distinct steps +- The work spans multiple files, tools, or phases +- You want to show the user a clear picture of what you're about to do before starting + +## Workflow + +1. Call `task_plan` to create the checklist +2. Rename `__todo` → `__wip` when work begins (via `file_edit` or shell) +3. Call `task_complete` after each step finishes +4. Use `file_*` tools to add, remove, or revise steps as the plan evolves +5. Rename `__wip` → `__done` when the goal is fully realized + +## How to use + +``` +execute_tool: task_plan (or use the built-in task server directly) +args: ["", "", "", ...] +``` + +``` +execute_tool: task_complete +args: ["", ""] +``` + +`task_complete` matches the step title case-insensitively and errors if no unchecked step matches — silent skips are caught. + +## Notes + +- Plan files live in `pl/` under the ollie mount +- List plans: `file_glob` on `ollie/pl/` +- Inspect a plan: `file_read` on the plan file +- Bulk edits: `file_edit` or `execute_code`