add task skill: guidance on task_plan and task_complete

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Levi Neely 2026-04-14 17:31:02 +02:00
parent 5436ee4119
commit e88e8b6b94
1 changed files with 44 additions and 0 deletions

44
task/SKILL.md Normal file
View File

@ -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: ["<goal>", "<step1>", "<step2>", ...]
```
```
execute_tool: task_complete
args: ["<plan-filename>", "<step-title-substring>"]
```
`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`