comet-tweak

comet-tweak is a skill for Claude Code, Codex from rpamis/comet. It costs 32 tokens per session (4,010 once invoked), scanned A, original, MIT.

A Comet workflow for small or medium changes that can be described as one OpenSpec change. OpenSpec is a specification-driven way to plan and apply software changes.

In plain words
What is it for?
Use it for configuration edits, documentation or prompt updates, and other contained changes that do not require coordination across multiple parts of a system.
Why use it?
It gives focused changes a defined path from opening the change through implementation, checking, and archiving without requiring the full design process.

Skill for Claude CodeCodex

About the project

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.

rpamis/comet · 2,914 stars · on GitHub

Install

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.

agentmods
npx agentmods add skills/rpamis/comet/comet-tweak
Any agent
npx skills add rpamis/comet --skill comet-tweak
Clone the repo
git clone --depth 1 https://github.com/rpamis/comet

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for comet-tweak

README.md
[![agentmods](https://agentmods.dev/badge/skills/rpamis/comet/comet-tweak.svg)](https://agentmods.dev/skills/rpamis/comet/comet-tweak)
Your own site
<a href="https://agentmods.dev/skills/rpamis/comet/comet-tweak"><img src="https://agentmods.dev/badge/skills/rpamis/comet/comet-tweak.svg" alt="Measured on agentmods" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,010 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00032 $0.04010
Opus 5 $0.00016 $0.02005
Sonnet 5 $0.00006 $0.00802
Haiku 4.5 $0.00003 $0.00401

Measured 2d ago against content hash d972870cc691, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

comet-tweak 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 2d 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.

assets/skills-zh/comet-tweak/SKILL.md · 211 lines

How it starts

The opening of the file, as written. The whole thing — 211 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Comet 预设路径:Tweak

开始或恢复前必须先读取并执行 comet-classic/reference/classic-layout.md;本文件中的 OpenSpec CLI 调用必须使用 adapter,文件路径必须使用该协议绑定的 <classic-*> 逻辑根。

Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程。它串联 OpenSpec 的核心流程,复用 open、build、verify、archive 能力,仅跳过 Superpowers brainstorming 和完整 plan。

适用于串联 OpenSpec 的轻量改动,例如配置调整、文档或 prompt 优化,以及需 spec 驱动(含 delta spec)但不需要完整 /comet-classic 深度设计流程的中等变更。delta spec 在 tweak 中是一等公民正常产物,需要 delta spec 本身不构成升级理由。

适用条件(必须全部满足):

  1. 可收敛为单一 OpenSpec change
  2. 不需要 Superpowers Design Doc 和完整 plan 才能澄清方案
  3. 不涉及跨模块、跨层级的架构协调
  4. 任务规模可预估(文件数和任务数仅作提示,不作为硬性升级条件,见下方升级判定)

不适用:如变更过程中命中质变信号(见「升级判定」章节),由用户决定是否升级为完整 /comet-classic 流程。


流程(预设流程,4 阶段)

0. 输出语言约束

精简版 OpenSpec 产物必须使用 Comet 配置产物语言。.comet.yaml 尚不存在时依次读取项目 .comet/config.yaml 和全局 ~/.comet/config.yamlclassic.language,初始化后使用 comet state get <name> language 读取。

执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。

开始前按 comet-classic/reference/scripts.md 运行公开 Comet CLI 命令;从任意入口恢复时先按 comet-classic/reference/context-recovery.md 检查 phase/workflow。

恢复已有 tweak change 时,第一项状态操作必须是 comet state select <change-name>;创建新 change 时,在 .comet.yaml 初始化成功后立即运行该命令,再进入源码写入步骤。

进入 tweak 工作区并读取当前状态 phase 后,运行 comet task <project-root> --task "<用户原始请求>" --phase "<phase>" --session "<本次任务稳定标识>" --json。只注入返回的 text;Context Manifest(manifest / <context_manifest>)只含摘要、应用原因和稳定 ID,需要正文、来源或验证方式时增加 --expand-context "<id>",路径、操作或阶段变化时以同一 --session 重新选择。用户明确要求长期记住时调用 comet memory remember ... --scope global|project;仅对隐式但可复用的稳定协作方式调用 comet memory observe,不得保存任务摘要、进展、命令输出或测试结果。实际使用条目且结果明确后,用 applications[].applicationId(Hook 文本中的 application_id)运行 comet task <project-root> --task "<用户原始请求>" --application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure --json。任务结束仍运行带 --complete --workflow <workflow> --change <change-id>comet task。无 Hook 时由本 Skill 使用相同接口,comet memory context 只作为兼容入口;插件失败不阻断变更。

Read the full file on GitHub · 211 lines

Files

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.

Changes

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.

  1. 2d ago Changed · +2 lines d972870cc691
  2. 4d ago First seen · 209 lines · 32 tokens per session scan A 7cb6d2f0a92d

Subscribe to this mod's changes

comet-tweak is a skill published in the GitHub repository rpamis/comet (2,914 stars, last pushed today), licensed MIT. It adds 32 tokens to every session and 4,010 once invoked, about $0.0002 per session on Opus 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.

Related

Other skills, from other repositories

agent-spec-tool-first

CRITICAL: Use for agent-spec CLI tool workflow. Triggers on: agent-spec, contract, lifecycle, guard, verify, explain, stamp, checkpoint, plan, requirements, work-units, knowledge requirements, KLL, docs vs knowledge, spec verification, task contract, spec quality, lint spec, run log, "how to verify", "how to use…

ZhangHanDong/agent-spec · 165 tokens

agent-spec-authoring

CRITICAL: Use for writing and editing agent-spec .spec/.spec.md files. Triggers on: write spec, create spec, edit spec, new spec, spec authoring, task contract, .spec file, .spec.md file, BDD scenario, acceptance criteria, completion criteria, test selector, boundary, constraint, intent, decision, out of scope, "how…

ZhangHanDong/agent-spec · 172 tokens

agent-spec-estimate

CRITICAL: Use for estimating work effort from agent-spec Task Contracts. Triggers on: estimate, estimation, how long, work effort, round count, time estimate, scope, sizing, cost, budget, planning, sprint, capacity, "how many rounds", "how long will this take", "estimate this spec", 估算, 工作量, 多久, 时间估算, 预估, 工时, 规模…

ZhangHanDong/agent-spec · 116 tokens

agent-spec-intent-compiler

Use when converting PRD or issue prose into KLL requirements, running the intent compiler plan, or reverse-interviewing a human to resolve requirement ambiguity before task spec generation.

ZhangHanDong/agent-spec · 42 tokens

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.…

sd0xdev/sd0x-harness · 112 tokens

codex-setup

Initialize sd0x-dev-flow infrastructure for Codex CLI and other non-Claude agents. Generates AGENTS.md, installs the commit-msg hook, copies runner scripts. The pre-push gate is opt-in via --with-push-gate. Use when setting up a new project or after updating skills.

sd0xdev/sd0x-harness · 65 tokens