Comet Design
Generate design documents and specifications through structured brainstorming.
Installation
- Make sure Claude is on your device and in your terminal.
Skills load from
~/.claude/skills/when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then runclaudein any terminal to verify.One-time setupnpm i -g @anthropic-ai/claude-codeAlready have it? Skip ahead.
- Paste into Claude Code or into your terminal.
This copies the whole skill folder into
~/.claude/skills/comet-design-rpamis/— the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.Faster alternative (instruction-only skills)
Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.
Quick install (SKILL.md only)Sign up to copy - Restart Claude Code.
Quit and reopen Claude Code (or any other agent that loads from
~/.claude/skills/). New skills are picked up on startup. - Just ask Claude.
Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.
Prefer to read the source first? Open on GitHub.
When Claude uses it
Use when starting a design document — runs a structured brainstorm and turns the decisions into a design doc and specification.
What this skill does
Comet Design guides you through a structured brainstorming and design process for creating technical design documents. It integrates with OpenSpec (the upstream specification source) and Superpowers brainstorming to ensure your design decisions are grounded in confirmed requirements and clear about trade-offs and risks.
What it does
- Validates prerequisites — Checks that a change already has proposal, design, and tasks files, and that no Design Doc yet exists.
- Generates a handoff context pack — Creates machine-readable and human-readable context from OpenSpec (proposal, design, tasks, and specs) to feed into brainstorming, marked with source paths and hashes for full traceability.
- Runs structured brainstorming — Loads the Superpowers brainstorming skill with the handoff context to explore implementation approaches, technical risks, test strategies, and edge cases in conversation.
- Blocks for user confirmation — Pauses after brainstorming to show you the chosen approach, key trade-offs, and any spec patches needed, then waits for your explicit approval before creating the final Design Doc.
- Creates the Design Doc — Writes
docs/superpowers/specs/YYYY-MM-DD-<topic>-design.mdwith minimal frontmatter linking it back to your change and OpenSpec as the canonical source. - Updates state and applies guards — Records the Design Doc path, regenerates the handoff if specs changed, and runs phase guards to confirm all outputs are valid before moving to the build phase.
How to use it
Invoke this skill when you are ready to begin the design phase of an active change. Provide the change name. The skill will verify that proposal, design, and task files exist, generate context from OpenSpec, then guide you through a brainstorming conversation with the Superpowers skill to develop and confirm your technical approach before writing the final Design Doc.
Related skills
Documentation Co-Authoring
anthropics
Guide structured workflows for writing docs, proposals, and technical specs collaboratively.
MCP Server Builder
anthropics
Build protocol servers that connect language models to external APIs and services.
Ask Questions If Underspecified
trailofbits
Ask clarifying questions before starting work on ambiguous requests.
Claude Plugin Marketplace Builder
daymade
Convert a Claude skills repository into an installable marketplace with auto-updates.