Comet Design

Comet Phase 2: Deep Design. Invoke with /comet-design. Produce Design Doc and delta spec through brainstorming.

3,306 stars 317 forksOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add rpamis/comet --skill comet-design
Manual install
git clone --depth 1 https://github.com/rpamis/comet.git /tmp/comet
mkdir -p ~/.claude/skills
cp -r /tmp/comet/eval/local/skills/benchmarks/039-release/comet-classic-039-design ~/.claude/skills/comet-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Comet Phase 2: Deep Design (Design)

## Prerequisites

- Active change exists (proposal.md, design.md, tasks.md)
- No Design Doc (no corresponding file under `docs/superpowers/specs/`)

## Steps

### 0. Entry State Verification (Entry Check)

Execute entry verification:

```bash
COMET_ENV="${COMET_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" "$HOME/.gemini" -path '*/comet/scripts/comet-env.sh' -type f -print -quit 2>/dev/null)}"
if [ -z "$COMET_ENV" ]; then
  echo "ERROR: comet-env.sh not found. Ensure the comet skill is installed." >&2
  return 1
fi
. "$COMET_ENV"
"$COMET_BASH" "$COMET_STATE" check <name> design
```

Proceed to Step 1 after verification passes. The script outputs specific failure reasons when verification fails.

**Idempotency**: All design phase operations can be safely re-executed. If `handoff_context` and `handoff_hash` already exist, confirm they match current artifacts before deciding whether to regenerate.

### 1a. Generate OpenSpec → Superpowers Handoff Package

**Must be generated by script. Agent writing summaries on the fly is not allowed.**

```bash
"$COMET_BASH" "$COMET_HANDOFF" <change-name> design --write
```

The script reads the change `.comet.yaml` `context_compression` snapshot, then generates and records the matching handoff package.

Default `context_compression: off` generates:

```
openspec/changes/<name>/.comet/handoff/design-context.json
openspec/changes/<name>/.comet/handoff/design-context.md
```
Read the full skill on GitHub

Details

Skill name
comet-design
Repository
rpamis/comet
Path
eval/local/skills/benchmarks/039-release/comet-classic-039-design/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the Comet Design skill do?

Comet Phase 2: Deep Design. Invoke with /comet-design. Produce Design Doc and delta spec through brainstorming.

How do I install the Comet Design skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add rpamis/comet --skill comet-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Comet Design popular?

It lives in rpamis/comet, which has 3,306 GitHub stars and 317 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.