Plan

Turns specs, briefs, or feature requests into structured task lists that can stand alone without the original context. It writes each task with enough background that someone reading it six months later, or an AI agent starting fresh, can actually execute it. The output lives in your docs folder or gets returned in chat, not pushed straight to your issue tracker. What's honest here is that it forces you to think through dependencies and acceptance criteria up front, which means you'll catch the "wait, how does error handling work across these three tasks" problems during planning instead of mid-implementation. Works best when your input is concrete enough to have real task boundaries.

skills.sh installs: 773
GitHub stars: 428
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add owainlewis/blueprint --skill plan --agent claude-code

Installs into .claude/skills of the current project.

Files

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.>

SKILL.md on GitHub