| name | skill-planner |
| description | Create phased implementation plans from research findings. Invoke when a task needs an implementation plan. |
| allowed-tools | Task, Bash, Edit, Read, Write |
| context | fork |
| agent | planner-agent |
Planner Skill
Thin wrapper that delegates plan creation to planner-agent.
OpenCode planning skill wrapper.
Delegate planning and coordinate postflight updates.
Delegation skill for planning workflows.
Validate planning inputs, delegate plan creation, and update task state.
See Execution Flow for preflight/delegation/postflight steps.
Validate metadata file, plan artifact, and status updates.
<return_format>Brief text summary; metadata file in specs/{N}_{SLUG}/.return-meta.json.</return_format>
Context References
Reference (do not load eagerly):
- Path:
.opencode/context/core/formats/return-metadata-file.md - Metadata file schema
- Path:
.opencode/context/core/patterns/postflight-control.md - Marker file protocol
- Path:
.opencode/context/core/patterns/file-metadata-exchange.md - Metadata file handling
- Path:
.opencode/context/core/patterns/jq-escaping-workarounds.md - jq workaround patterns
- Path:
.opencode/context/index.md - Context discovery index
Trigger Conditions
- Task status allows planning
- /plan command invoked
Execution Flow
- Validate task and status.
- Update status to planning.
- Create postflight marker file.
- Delegate to
planner-agent via Task tool.
- Read metadata file and update state + TODO.
- Link plan artifact and commit.
- Clean up marker and metadata files.