Turns high-level objectives into modular, independently executable step-by-step plans for coding agents.

Install

mkdir -p .claude/skills/blueprint && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/9817" && unzip -o skill.zip -d .claude/skills/blueprint && rm skill.zip

Installs to .claude/skills/blueprint

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Turn a one-line objective into a step-by-step construction plan any coding agent can execute cold. Each step has a self-contained context brief — a fresh agent in a new session can pick up any step without reading prior steps.
226 charsno explicit “when” trigger
Intermediate

Key capabilities

  • Decompose objectives into PR-sized steps
  • Generate self-contained context briefs for tasks
  • Identify parallelism in construction plans
  • Perform adversarial review of plans

How it works

It breaks down a high-level objective into a sequence of independently executable tasks, each with its own context brief for cold-start execution.

Inputs & outputs

You give it
Project objective
You get back
Step-by-step construction plan

When to use blueprint

  • Planning multi-PR database migrations
  • Refactoring large legacy modules
  • Managing long-running architectural changes

About this skill

Blueprint — Construction Plan Generator

Turn a one-line objective into a step-by-step plan any coding agent can execute cold.

Overview

Blueprint is for multi-session, multi-agent engineering projects where each step must be independently executable by a fresh agent that has never seen the conversation history. Install it once, invoke it with /blueprint <project> <objective>.

When to Use This Skill

  • Use when the task requires multiple PRs or sessions
  • Use when multiple agents or team members need to share execution
  • Use when you want adversarial review of the plan before execution
  • Use when parallel step detection and dependency graphs matter

How It Works

  1. Research — Scans the codebase, reads project memory, runs pre-flight checks
  2. Design — Breaks the objective into one-PR-sized steps, identifies parallelism, assigns model tiers
  3. Draft — Generates the plan from a structured template with branch workflow rules, CI policy, and rollback strategies inline
  4. Review — Delegates adversarial review to a strongest-model sub-agent (falls back to default model if unavailable)
  5. Register — Saves the plan and updates project memory

Examples

Example 1: Database migration

/blueprint myapp "migrate database to PostgreSQL"

Example 2: Plugin extraction

/blueprint antbot "extract providers into plugins"

Best Practices

  • ✅ Use for tasks requiring 3+ PRs or multiple sessions
  • ✅ Let Blueprint auto-detect git/gh availability — it degrades gracefully
  • ❌ Don't invoke for tasks completable in a single PR
  • ❌ Don't invoke when the user says "just do it"

Key Differentiators

  • Cold-start execution: Every step has a self-contained context brief
  • Adversarial review gate: Strongest-model review before execution
  • Zero runtime risk: Pure markdown — no hooks, no scripts, no executable code
  • Plan mutation protocol: Steps can be split, inserted, skipped with audit trail

Installation

mkdir -p ~/.claude/skills
git clone https://github.com/antbotlab/blueprint.git ~/.claude/skills/blueprint

Additional Resources

When not to use it

  • Tasks completable in a single PR
  • When the user requests immediate execution without planning

Prerequisites

Git

Limitations

  • Not suitable for single-PR tasks
  • Relies on model-based adversarial review

How it compares

It provides self-contained context for every step, allowing different agents to execute tasks without needing full conversation history.

Compared to similar skills

blueprint side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
blueprint (this skill)04moReviewIntermediate
create-plan368moReviewBeginner
project-planner329moReviewIntermediate
system-design199moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

create-plan

antinomyhq

Generate detailed implementation plans for complex tasks. Creates comprehensive strategic plans in Markdown format with objectives, step-by-step implementation tasks using checkbox format, verification criteria, risk assessments, and alternative approaches. Use when users need thorough analysis and structured planning before implementation, when breaking down complex features into actionable steps, or when they explicitly ask for a plan, roadmap, or strategy. Strictly planning-focused with no code modifications.

36121

project-planner

adrianpuiu

Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking. Use when starting a new project, defining specifications, creating technical designs, or breaking down complex systems into implementable tasks. Supports user story format, acceptance criteria, component design, API specifications, and hierarchical task decomposition with requirement traceability.

32115

system-design

lagz0ne

Use when designing, architecting, or planning a new system from requirements or ideas - transforms concepts into navigable design catalog using EventStorming methodology, Mermaid diagrams, and progressive elaboration through 5 phases (Requirements, Big Picture, Processes, Data/Flows, Integration)

19108

spec-kit-workflow

jmanhype

Guides specification-driven development workflow. Automatically invoked when discussing new features, specifications, technical planning, or implementation tasks. Ensures proper workflow phases (specify → clarify → plan → checklist → tasks → analyze → implement).

11111

sparc-methodology

ruvnet

SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) comprehensive development methodology with multi-agent orchestration

8100

spec-workflow

TencentCloudBase

Standard software engineering workflow for requirement analysis, technical design, and task planning. Use this skill when developing new features, complex architecture designs, multi-module integrations, or projects involving database/UI design.

1091

Search skills

Search the agent skills registry