A skill your agent uses when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。
$ npx skills add rpamis/comet --skill comet-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install rpamis/comet comet-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .claude/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .claude/skills/comet-design && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .claude/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add rpamis/comet --skill comet-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install rpamis/comet comet-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .agents/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .agents/skills/comet-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .agents/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rpamis/comet --skill comet-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install rpamis/comet comet-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .cursor/skills/comet-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .cursor/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/rpamis/comet.git --path eval/local/skills/benchmarks/040-beta/comet-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add rpamis/comet --skill comet-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install rpamis/comet comet-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .gemini/skills/comet-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .gemini/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install rpamis/comet comet-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add rpamis/comet --skill comet-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .github/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .github/skills/comet-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .github/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rpamis/comet --skill comet-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install rpamis/comet comet-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/eval/local/skills/benchmarks/040-beta/comet-design .opencode/skills/comet-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "comet-design" agent skill from https://github.com/rpamis/comet/tree/master/eval/local/skills/benchmarks/040-beta/comet-design into .opencode/skills/comet-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "comet-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
comet-designA skill your agent uses when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。
Comet Design is an agent skill from rpamis/comet. Use when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Architecture decision records and Brainstorming. The repository describes itself as: Comet: agent skill harness for turning ideas into evaluated workflows. The licence is MIT.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 0fd42a0. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
nodeFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Comet Design loads about 1.9k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 433 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from rpamis/comet at commit 0fd42a0, republished under its MIT licence (© rpamis). 433 words, ~1,892 tokens.
.claude/skills/comet-design/SKILL.md (or your agent's skills folder).docs/superpowers/specs/ 下无对应文件）职责边界：open 阶段的
design.md给出高层方案框架（架构决策方向、方案选型、数据流）；design 阶段的 Design Doc 是对它的深度技术细化（详细实现设计、技术风险、测试策略、边界条件），是深化而非替代或重写。
按 comet/reference/scripts.md 定位脚本（定位 comet-env.mjs），然后执行入口验证；从任意入口恢复时先按 comet/reference/context-recovery.md 运行恢复检查：
node "$COMET_STATE" check <name> design验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
幂等性：所有 design 阶段操作可以安全重试。如果 handoff_context 和 handoff_hash 已存在，先确认它们与当前产物一致再决定是否重新生成。
必须由脚本生成，不允许 agent 临场手写 summary 代替。
node "$COMET_HANDOFF" <change-name> design --write脚本会根据 change .comet.yaml 的 context_compression 快照生成并记录交接包。
默认 context_compression: off 时生成：
openspec/changes/<name>/.comet/handoff/design-context.json
openspec/changes/<name>/.comet/handoff/design-context.md启用 beta（项目 .comet/config.yaml 中 context_compression: beta，创建 change 时快照进入 .comet.yaml）时生成：
openspec/changes/<name>/.comet/handoff/spec-context.json
openspec/changes/<name>/.comet/handoff/spec-context.md并在 .comet.yaml 写入：
handoff_context: openspec/changes/<name>/.comet/handoff/design-context.json
handoff_hash: <sha256>默认交接包是 compact 可追溯摘录，不是 agent summary：
design-context.json：机器索引，包含 change、phase、canonical spec、source paths、hashdesign-context.md：供 Superpowers 阅读的上下文，包含脚本标记、source path、line range、sha256、确定性摘录[TRUNCATED]，并保留 Full source 路径beta 交接包是 结构化 spec projection，用于减少 OpenSpec 原文 token 占用但避免实现漂移：
spec-context.json：机器索引，包含 change、phase、mode=beta、source paths、context_hash、files 角色spec-context.md：供 Superpowers 阅读的紧凑上下文，verbatim 投影 delta spec 文件并按 hash 引用支撑产物如确实需要全文上下文，可显式运行：
node "$COMET_HANDOFF" <change-name> design --write --full交接包来源来自 OpenSpec open 阶段产物：
proposal.md：目标、动机、范围、非目标design.md：高层架构决策、方案约束tasks.md：初始任务边界specs/*/spec.md：delta 能力规格立即执行： 使用 Skill 工具加载 Superpowers brainstorming 技能。禁止跳过此步骤。
技能加载时，ARGUMENTS 必须包含：
Language: 使用触发本次工作流的用户请求语言输出技能加载后，按其指引使用以下上下文：
Change: <change-name>
OpenSpec Context Pack: openspec/changes/<name>/.comet/handoff/design-context.md
Machine handoff: openspec/changes/<name>/.comet/handoff/design-context.json
如 context_compression: beta，则使用：
OpenSpec Context Pack: openspec/changes/<name>/.comet/handoff/spec-context.md
Machine handoff: openspec/changes/<name>/.comet/handoff/spec-context.json
OpenSpec 产物是上游事实源，但不得用“跳过重复上下文探索”削弱 Superpowers `brainstorming` 的澄清流程。
你的任务是基于交接包做深度技术设计：实现方案、技术风险、测试策略、边界条件。
如发现目标、范围、非目标、验收场景或关键约束仍不清楚，必须先继续提问并形成设计方案，不得只进行一轮问答就创建 Design Doc。
不要重写 proposal/spec；如发现 OpenSpec delta spec 缺少验收场景，只能提出 Spec Patch，并回写 OpenSpec delta spec；不要在 Design Doc 中创建第二份需求 spec。Spec Patch 仅限于补充验收场景、修正歧义描述或添加边界条件，不得大幅重写 delta spec 的结构或范围——如需大幅修改，应标记为设计发现并回到 brainstorming 确认。
Design Doc frontmatter 必须最小化，只包含：
---
comet_change: <change-name>
role: technical-design
canonical_spec: openspec
---
按 Superpowers `brainstorming` 技能原流程推进：澄清问题、2-3 个方案、分段确认设计。不得提前写入 Design Doc。禁止在未加载该技能的情况下继续。
如 Superpowers brainstorming 技能不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
技能加载后，按其指引产出设计方案（以对话形式呈现）：
brainstorming 阶段不写入 Design Doc 文件，仅产出设计方案供 Step 1c 用户确认。确认后才创建 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并回写 delta spec。
但为了上下文压缩恢复，brainstorming 过程中必须增量更新 brainstorm-summary.md。每轮澄清或方案迭代后，只要产生新的已确认事实、关键约束、候选方案、取舍/风险、测试策略或 Spec Patch 候选，就更新该文件；未确认内容必须标注为“待确认”或“候选”。该文件是恢复检查点，不是 Design Doc，也不得替代 Step 1c 的用户确认。
brainstorming 产出设计方案后，必须按 comet/reference/decision-point.md 的协议暂停并等待用户明确确认设计方案。不得在用户确认前创建最终 Design Doc、写入 design_doc、运行 design guard，或进入 /comet-build。
暂停时只展示必要摘要：
用户明确确认后，才继续 Step 2。若用户要求调整，继续 brainstorming 迭代，直到用户确认。
用户确认设计方案后，在创建 Design Doc 前，创建或更新已增量维护的检查点文件，将其定稿为确认后的设计方案摘要：
mkdir -p openspec/changes/<name>/.comet/handoffopenspec/changes/<name>/.comet/handoff/brainstorm-summary.md 结构：
# Brainstorm Summary
- Change: <change-name>
- Date: <YYYY-MM-DD>
## 确认的技术方案
<用户确认的方案摘要>
## 关键取舍与风险
<主要取舍和风险>
## 测试策略
<测试方法概述>
## Spec Patch
<将回写的 delta spec 变更，无则写"无">上下文压缩说明：每次增量更新 brainstorm-summary.md 后，都是相对安全的压缩恢复点。Brainstorming 完成后，如上下文窗口紧张，应优先在此处进行压缩。压缩后重新加载以下文件继续 Step 2：
openspec/changes/<name>/.comet/handoff/brainstorm-summary.mdopenspec/changes/<name>/.comet/handoff/design-context.md（或 beta 模式的 spec-context.md）openspec/changes/<name>/.comet/handoff/design-context.json（或 beta 模式的 spec-context.json）完成 Step 1d 并确认 brainstorm-summary.md 已写入后，进入 Design Doc 创建前的主动式上下文压缩。此时 OpenSpec 交接包、brainstorming 决策和待确认项都已落盘，应主动释放前面读取 Spec 和 brainstorming 消耗的上下文，为 Step 2 及后续 Build 阶段保留窗口。
执行规则：
基于 brainstorming 对话的完整上下文（仍在主 session 中），创建 Design Doc。
Design Doc frontmatter 必须最小化：
---
comet_change: <change-name>
role: technical-design
canonical_spec: openspec
---将 Design Doc 写入 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md。
如需回写 delta spec（Spec Patch），同时编辑对应的 specs/*/spec.md。
上下文压缩恢复：若上下文已被压缩，从 brainstorm-summary.md + handoff 上下文恢复。若用户尚未确认设计方案，回到 Step 1b/1c 继续 brainstorming；若用户已确认，继续创建 Design Doc。brainstorm-summary.md 是压缩恢复的落盘点，不是 Design Doc 的唯一输入——创建时应尽可能利用恢复后的完整上下文。
先记录 design_doc 路径。如果 Spec Patch 回写了 delta spec（新增或修改了 specs/*/spec.md），必须重新生成 handoff 以更新 hash：
# 记录 design_doc 路径
node "$COMET_STATE" set <name> design_doc docs/superpowers/specs/YYYY-MM-DD-topic-design.md
# 如有 delta spec 变更，重新生成 handoff（更新 hash）
node "$COMET_HANDOFF" <change-name> design --write
# 阶段守卫推进 phase 到下一阶段
node "$COMET_GUARD" <change-name> design --apply如果没有 delta spec 变更，跳过 handoff 重新生成步骤。状态文件自动更新，无需手动编辑其他字段。
comet_change、role: technical-design、canonical_spec: openspechandoff_context 和 handoff_hash 已写入 .comet.yaml（由 guard 强制校验）handoff_hash 与当前 OpenSpec open 阶段产物一致（由 guard 强制校验）design-context.md 或 beta spec-context.md 必须是脚本生成，且包含 source path、mode、sha256 等可追溯标记（由 guard 强制校验）spec-context.json 必须结构合法且引用当前源文件（由 guard 强制校验）design_doc 已写入 .comet.yamlnode "$COMET_GUARD" <change-name> design --apply，全部 PASS 后由守卫推进到 phase: build（此步骤更新 phase 字段，与 auto_transition 无关）退出前必须使用 --apply：
node "$COMET_GUARD" <change-name> design --apply按 comet/reference/context-recovery.md 执行，phase 参数为 design。
按 comet/reference/auto-transition.md 执行。关键命令：
node "$COMET_STATE" next <change-name>NEXT: auto → 调用 SKILL 指向的 skill 进入下一阶段NEXT: manual → 不要调用下一 skill，按 HINT 提示用户手动运行 /<SKILL>NEXT: done → 流程已完成，无需继续© rpamis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in eval/local/skills/benchmarks/040-beta/comet-design of rpamis/comet.
Open the folder on GitHubat commit 0fd42a0
Comet Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Comet Design this skillrpamis/comet | 3.2k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Macro Idea Generationagentii-ai/agentii-investment-intelligence | 207 | — | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Grounding A Designandrew-blake/melcloudhome | 142 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Brainstormingfeiskyer/claude-code-settings | 1.7k | — | ~985 | Automated safety check: Pass | MIT | |
| Track Ideacdiggins/plato | 106 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Octocode Rfc Generatorbgauryy/octocode | 949 | — | ~1.1k | Automated safety check: Pass | MIT |
agentii-ai/agentii-investment-intelligence
Macro-driven trade idea generation, translating macroeconomic views into concrete stock ideas, sector selection from macro regime, international trade ideas via ADRs, cross-border idea sourcing…
andrew-blake/melcloudhome
A skill your agent uses when about to propose, brainstorm, review or revise a design, fix approach or plan for a feature or behaviour change in this repo, including "brief" or "quick" design…
feiskyer/claude-code-settings
Explore user intent, requirements, and design options through collaborative dialogue before implementation.
cdiggins/plato
Log a new idea into tracker/ with elaboration — assumptions, design decisions, related work links, approach brainstorm, and simplest implementation.
bgauryy/octocode
A skill your agent uses when a consequential change needs a decision before coding: write or improve an RFC, design doc, architecture proposal, migration plan, option comparison, rollout plan, or…
harperreed/dotfiles
A skill your agent uses when you want to build a project but don't have a spec yet and need to brainstorm the idea into a design doc structured for pipeline DOT generation.
rpamis/comet
A skill your agent uses when 用户要启动或恢复 Comet 工作流，需要根据 active change、.comet.yaml、hotfix/tweak 意图路由到对应阶段 Skill。
rpamis/comet
Comet workflow entry. An agent skill from rpamis/comet.
rpamis/comet
Comet — OpenSpec + Superpowers dual-star development workflow.
rpamis/comet
Archive and deliver a Classic change. An agent skill from rpamis/comet.
rpamis/comet
Comet Classic workflow entry. An agent skill from rpamis/comet.
rpamis/comet
Complete the Classic technical design and obtain user confirmation.
Categories
A skill your agent uses when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复。. Comet Design is an agent skill from rpamis/comet.
Comet Design fits situations like: full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc，或 design 阶段需要从 OpenSpec 交接包恢复; tasks that involve Architecture decision records; tasks that involve Brainstorming.
Run `npx skills add rpamis/comet --skill comet-design -a claude-code`. Or copy the skill folder (eval/local/skills/benchmarks/040-beta/comet-design in rpamis/comet) into .claude/skills/comet-design in your project. Claude Code loads it when a task matches its description.
Run `npx skills add rpamis/comet --skill comet-design -a codex`. Or copy the skill folder (eval/local/skills/benchmarks/040-beta/comet-design in rpamis/comet) into .agents/skills/comet-design in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rpamis/comet --skill comet-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/comet-design, .gemini/skills/comet-design, .github/skills/comet-design and .opencode/skills/comet-design in your project.
Going by SKILL.md and its folder, Comet Design needs the command-line tools its instructions call (node).
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Comet Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Comet Design: Macro Idea Generation (agentii-ai/agentii-investment-intelligence, 207 stars), Grounding A Design (andrew-blake/melcloudhome, 142 stars), Brainstorming (feiskyer/claude-code-settings, 1.7k stars) and Track Idea (cdiggins/plato, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
rpamis (a GitHub organization) maintains it in rpamis/comet, which has 3,166 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 9, 2026.
Source: rpamis/comet on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
