plan
Splits a spec into small tasks, each a working slice an agent can finish in one pull request. Use when a spec is too big for one PR, or to create tracker tickets.
How do I install this agent skill?
npx skills add https://github.com/owainlewis/blueprint --skill planIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a purely instructional tool for task planning and decomposition. It contains no executable code, network operations, or sensitive data access, and functions as a template for organizing work items.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Plan
Split decided work into tasks that each deliver something that works, end to end, in one pull request. Split by result, never by layer: "add a task and see it after a restart" is one task covering input, storage, and output, not three.
Steps
- Read the spec, the repository instructions, and the code it touches. If a decision is missing, return to spec.
- Write each task with the template below. Keep shared contracts in one task, and put refactoring in its own task if it would hide a behavior change.
- Order tasks by dependency. Group them into milestones only when a milestone is itself a usable result.
- Return the plan in chat. Create tracker tickets only if the user asks. Do not write a plan file or start building.
Template
## <Action and result, in plain words>
### What are we building?
<One to three sentences: what is missing today and what will work after this task.>
### Why?
<One or two sentences on the value to a user or developer.>
### Done when
- <Three to seven results someone can see or test. Keep AC-n, J-n, and REQ-n IDs.>
### How to check
<Exact commands, and any manual check.>
### Agent notes
- Depends on: <task titles, or None>
- Source: <link to the spec section>
- <Decisions and failure rules specific to this task. Link the spec for the rest.>
### Out of scope
- <Nearby work this task might absorb by mistake.>
Rules
- A human should understand the task from the title and first two sections alone. Keep IDs and implementation detail out of them.
- Say what happens, not the jargon: "sending the same event twice creates one reply", not "prove idempotency".
- Aim for 250 to 500 words a task. If it needs more, split it.
- A task is ready when a fresh agent could finish it without asking a product or design question.
Return
The ordered tasks, their dependencies, and any decision that still blocks building.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/owainlewis/blueprint/plan">View plan on skillZs</a>