feat: add blueprint skill for cold-start construction planning (#259)

* feat: add blueprint skill for cold-start construction planning * chore: sync generated files for blueprint skill --------- Co-authored-by: sck_0 <samujackson1337@gmail.com>
2026-03-11 00:24:45 +08:00
parent c864565ce7
commit 445f71d134
5 changed files with 114 additions and 9 deletions
--- a/CATALOG.md
+++ b/CATALOG.md
@@ -2,7 +2,7 @@

 Generated at: 2026-02-08T00:00:00.000Z

-Total skills: 1234
+Total skills: 1235

 ## architecture (80)

@@ -594,7 +594,7 @@ no matching field, parse error, widget... | makepad, reference | makepad, refere
 | `zod-validation-expert` | Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js... | zod, validation | zod, validation, typescript, first, schema, covers, parsing, custom, errors, refinements, type, inference |
 | `zustand-store-ts` | Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creati... | zustand, store, ts | zustand, store, ts, stores, typescript, subscribewithselector, middleware, proper, state, action, separation, building |

-## general (292)
+## general (293)

 | Skill | Description | Tags | Triggers |
 | --- | --- | --- | --- |
@@ -625,6 +625,7 @@ no matching field, parse error, widget... | makepad, reference | makepad, refere
 | `bill-gates` | Agente que simula Bill Gates — cofundador da Microsoft, arquiteto da industria de software comercial, estrategista tecnologico global, investidor sistemico e... | persona, business-strategy, technology, philanthropy | persona, business-strategy, technology, philanthropy, bill, gates, agente, que, simula, cofundador, da, microsoft |
 | `blockchain-developer` | Build production-ready Web3 applications, smart contracts, and decentralized systems. Implements DeFi protocols, NFT platforms, DAOs, and enterprise blockcha... | blockchain | blockchain, developer, web3, applications, smart, contracts, decentralized, implements, defi, protocols, nft, platforms |
 | `blog-writing-guide` | Write, review, and improve blog posts for the Sentry engineering blog following Sentry's specific writing standards, voice, and quality bar. Use this skill w... | blog, writing | blog, writing, write, review, improve, posts, sentry, engineering, following, specific, standards, voice |
+| `blueprint` | 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 age... | blueprint | blueprint, turn, one, line, objective, step, construction, plan, any, coding, agent, execute |
 | `brand-guidelines-anthropic` | Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand co... | brand, guidelines, anthropic | brand, guidelines, anthropic, applies, official, colors, typography, any, sort, artifact, may, benefit |
 | `brand-guidelines-community` | Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand co... | brand, guidelines, community | brand, guidelines, community, applies, anthropic, official, colors, typography, any, sort, artifact, may |
 | `bug-hunter` | Systematically finds and fixes bugs using proven debugging techniques. Traces from symptoms to root cause, implements fixes, and prevents regression. | bug, hunter | bug, hunter, systematically, finds, fixes, bugs, proven, debugging, techniques, traces, symptoms, root |
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
-<!-- registry-sync: version=7.3.0; skills=1234; stars=22029; updated_at=2026-03-09T11:00:46+00:00 -->
-# 🌌 Antigravity Awesome Skills: 1,234+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
+<!-- registry-sync: version=7.3.0; skills=1235; stars=22818; updated_at=2026-03-10T16:24:28+00:00 -->
+# 🌌 Antigravity Awesome Skills: 1,235+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More

-> **The Ultimate Collection of 1,234+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**
+> **The Ultimate Collection of 1,235+ Universal Agentic Skills for AI Coding Assistants — Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL**

 [![GitHub stars](https://img.shields.io/badge/⭐%2021%2C000%2B%20Stars-gold?style=for-the-badge)](https://github.com/sickn33/antigravity-awesome-skills/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
@@ -18,7 +18,7 @@
 [![Web App](https://img.shields.io/badge/Web%20App-Browse%20Skills-blue)](apps/web-app)
 [![Buy Me a Book](https://img.shields.io/badge/Buy%20me%20a-book-d13610?logo=buymeacoffee&logoColor=white)](https://buymeacoffee.com/sickn33)

-**Antigravity Awesome Skills** is a curated, battle-tested library of **1,234+ high-performance agentic skills** designed to work seamlessly across the major AI coding assistants.
+**Antigravity Awesome Skills** is a curated, battle-tested library of **1,235+ high-performance agentic skills** designed to work seamlessly across the major AI coding assistants.

 **Welcome to the V7.3.0 Release!** This repository gives your agent reusable playbooks for planning, coding, debugging, testing, security review, infrastructure work, product thinking, and much more.

@@ -32,7 +32,7 @@
 - [🎁 Curated Collections (Bundles)](#curated-collections)
 - [🧭 Antigravity Workflows](#antigravity-workflows)
 - [📦 Features & Categories](#features--categories)
- [📚 Browse 1,234+ Skills](#browse-1234-skills)
+- [📚 Browse 1,235+ Skills](#browse-1235-skills)
 - [🤝 How to Contribute](#how-to-contribute)
 - [💬 Community](#community)
 - [☕ Support the Project](#support-the-project)
@@ -281,7 +281,7 @@ The repository is organized into specialized domains to transform your AI into a

 Counts change as new skills are added. For the current full registry, see [CATALOG.md](CATALOG.md).

-## Browse 1,234+ Skills
+## Browse 1,235+ Skills

 - Open the interactive browser in [`apps/web-app`](apps/web-app).
 - Read the full catalog in [`CATALOG.md`](CATALOG.md).
--- a/data/catalog.json
+++ b/data/catalog.json
@@ -1,6 +1,6 @@
 {
  "generatedAt": "2026-02-08T00:00:00.000Z",
-  "total": 1234,
+  "total": 1235,
  "skills": [
    {
      "id": "00-andruia-consultant",
@@ -6453,6 +6453,30 @@
      ],
      "path": "skills/blog-writing-guide/SKILL.md"
    },
+    {
+      "id": "blueprint",
+      "name": "blueprint",
+      "description": "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.",
+      "category": "general",
+      "tags": [
+        "blueprint"
+      ],
+      "triggers": [
+        "blueprint",
+        "turn",
+        "one",
+        "line",
+        "objective",
+        "step",
+        "construction",
+        "plan",
+        "any",
+        "coding",
+        "agent",
+        "execute"
+      ],
+      "path": "skills/blueprint/SKILL.md"
+    },
    {
      "id": "box-automation",
      "name": "box-automation",
--- a/skills/blueprint/SKILL.md
+++ b/skills/blueprint/SKILL.md
@@ -0,0 +1,70 @@
+---
+name: blueprint
+description: "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."
+category: planning
+risk: safe
+source: community
+date_added: "2026-03-10"
+---
+
+# 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
+
+```bash
+mkdir -p ~/.claude/skills
+git clone https://github.com/antbotlab/blueprint.git ~/.claude/skills/blueprint
+```
+
+## Additional Resources
+
+- [GitHub Repository](https://github.com/antbotlab/blueprint)
+- [Examples: small plan](https://github.com/antbotlab/blueprint/blob/main/examples/small-plan.md)
+- [Examples: large plan](https://github.com/antbotlab/blueprint/blob/main/examples/large-plan.md)
--- a/skills_index.json
+++ b/skills_index.json
@@ -2579,6 +2579,16 @@
    "source": "unknown",
    "date_added": null
  },
+  {
+    "id": "blueprint",
+    "path": "skills/blueprint",
+    "category": "planning",
+    "name": "blueprint",
+    "description": "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 \u2014 a fresh agent in a new session can pick up any step without reading prior steps.",
+    "risk": "safe",
+    "source": "community",
+    "date_added": "2026-03-10"
+  },
  {
    "id": "box-automation",
    "path": "skills/box-automation",