Comet is a resumable workflow and skill platform for coding tasks, covering requirements work as well as skill creation, evaluation, and release. It supports separate Native and Classic workflows and can coordinate implementation and verification across isolated Git worktrees. The catalogue contains skills and instructions that implement Comet-related workflows.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add rpamis/comet --skill comet-designgit clone --depth 1 https://github.com/rpamis/cometWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/rpamis/comet/comet-design)<a href="https://agentmods.dev/skills/rpamis/comet/comet-design"><img src="https://agentmods.dev/badge/skills/rpamis/comet/comet-design/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/rpamis/comet/comet-design"><img src="https://agentmods.dev/badge/skills/rpamis/comet/comet-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- Socket pass
- Snyk pass
- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00030 | $0.04038 |
| Opus 5.5 | $0.00012 | $0.01615 |
| Sonnet 5.5 | $0.00006 | $0.00808 |
| Haiku 4.5 | $0.00003 | $0.00404 |
Grade A, and why
comet-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 15d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 266 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Comet 阶段 2:深度设计(Design)
收到入口返回的 layout 后,按 comet-classic/reference/classic-layout.md 确定各逻辑根对应的目录。当前上下文已有这份协议时,无需重复加载。本文件中的 OpenSpec CLI 调用均通过适配器执行,文件路径均基于已绑定的 <classic-*> 根目录,无需先额外运行 root show。
前置条件
- 活跃 change 已存在,Open 必需产物检查通过
- Runtime 当前的 phase 为 design;已有设计时从已有进度继续,不能因为设计文件存在就跳过用户确认
各文档的用途:proposal 记录目标与范围,spec 记录行为和验收要求,Design Doc 记录技术决策,plan 记录实施步骤,tasks.md 记录任务完成状态。已有
design.md时,在同一文件中补充必要设计,不另建一份相同的技术方案。正式技术设计以design_doc指向的文件为准;旧 change 已记录其他路径时,沿用该路径。其他文件只引用这份设计,不重复维护同一项决策。
步骤
0. 入口状态验证(Entry Check)
按 comet-classic/reference/scripts.md 使用正式支持的 Comet CLI,执行以下入口验证。从任意入口恢复任务时,先按 comet-classic/reference/context-recovery.md 检查恢复状态:
comet state select <change-name>
comet state check <name> design --json
上一阶段 guard 已成功返回本阶段状态信息时,直接使用其中的状态与 agent.continuation 继续,不重复 select/check;恢复任务、工作区变化或外部状态变化时,才执行上述入口验证。验证通过后,使用入口返回的 layout、configuration、nextAction 和协作进度摘要继续,不逐字段查询,也不重复 root show。正常进入本阶段时,只做入口检查;丢失上下文后恢复任务或需要读取详情时,按 context-recovery.md 处理。验证失败时,处理返回的具体原因。
恢复:先核对现有产物和用户确认记录,只补未完成的步骤。无论正常进入还是恢复任务,都要保留已登记且仍然有效的设计,并读取 data.designReadiness、data.issues 和 data.nextAction。补回缺失文件、纠正文件关联的 change,或更新过期 handoff,不清空 design_doc。用户已确认设计后,可以执行返回的 complete-design 动作;该命令会保留已完成的步骤。如果已经进入 Build,则只返回当前阶段的入口信息。
1a. 生成 OpenSpec → Superpowers 交接包
必须由脚本生成,不能由 Agent 手写摘要代替。
comet handoff <change-name> design --write
脚本会根据 change .comet.yaml 的 context_compression 快照生成并记录交接包。
默认 context_compression: off 时生成:
<classic-change-dir>/.comet/handoff/design-context.json
<classic-change-dir>/.comet/handoff/design-context.md
启用 beta(项目 .comet/config.yaml 中 classic.context_compression: beta,创建 change 时快照进入 .comet.yaml)时生成:
<classic-change-dir>/.comet/handoff/spec-context.json
<classic-change-dir>/.comet/handoff/spec-context.md
并在 .comet.yaml 写入:
handoff_context: <classic-change-ref>/.comet/handoff/design-context.json
handoff_hash: <sha256>
默认交接包由脚本摘录源文件,并保留来源信息,不是 Agent 撰写的摘要:
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 15d ago Changed · -2 lines 068c9de5835f
- 27d ago Changed · +8 lines 8ff625ba53b5
- 1mo ago Changed · -5 lines · +6 tokens per session 0c0e20a69167
- 1mo ago First seen · 265 lines · 24 tokens per session scan A de891cd07a75
comet-design is a skill published in the GitHub repository rpamis/comet (3,205 stars, last pushed yesterday), licensed MIT. It adds 30 tokens to every session and 4,038 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
push-ci
Push to remote and monitor CI. Validates branch safety, executes git push WITH explicit user approval, then monitors CI run status via gh CLI. Use when: user says 'push', 'push and watch CI', 'ship it', 'push-ci'. Not for: committing (use /smart-commit), creating PRs (use /create-pr), merging (use /merge-prep).
create-request
Create, update, or scan per-task request tickets for progress tracking. These are date-prefixed non-lifecycle docs under requests/, NOT feature-level requirements (use /req-analyze for those). Use when: tracking task progress, updating completion status, scanning incomplete requests, checking request status dashboard.…
gh-stack
Native stacked pull requests through the github/gh-stack extension. Detects the extension, installs it only after the user approves, resolves the branch chain, and executes gh stack link / gh stack push / gh stack submit --auto under a per-use AskUserQuestion gate. Use when: opening or refreshing a native stack of…
smart-rebase
Smart partial rebase for squash-merge repositories. Auto-detect which commits to keep/drop when base branch was squash-merged into target. Use when: user says 'rebase', 'partial rebase', 'base already merged', 'smart rebase', or /smart-rebase. Not for: simple git rebase (the developer runs it — no skill executes…
remind
A correction helper that checks which project rules or required steps were missed and loads the relevant guidance.
doc-review
Document review via Codex exec. Use when: reviewing .md docs, tech spec audit, document quality check. Not for: code review (use codex-code-review), test review (use test-review). Output: 5-dimension rating table + gate.