Agent skill

Comet

by rpamis in rpamis/comet

Comet workflow entry. An agent skill from rpamis/comet.

MITAuto-check passed

Install Comet

skills CLI
$ npx skills add rpamis/comet --skill comet -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rpamis/comet comet --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rpamis/comet.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assets/skills/comet .claude/skills/comet && rm -rf skills-src

Use ~/.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/

Facts

Skill name
comet
GitHub stars
3.2k
Token cost
~686 tokens
SKILL.md length
359 words
Files
22 (incl. scripts)
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Comet workflow entry. An agent skill from rpamis/comet.

  • Works in 3 steps: Run the Comet CLI installed on PATH in… → Parse the JSON. Only accept schema:… → Immediately use the Skill tool to load…
  • The user invokes /comet
  • Runs JavaScript scripts from its folder
  • Asks to use Comet without choosing Native

What it does

Comet is an agent skill from rpamis/comet. Comet workflow entry. Use when the user invokes /comet or asks to use Comet without choosing Native or Classic; load Native or Classic from project configuration.

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 26 other files, including scripts (for example `agents/openai.yaml`, `rules/comet-phase-guard.en.md` and `rules/comet-phase-guard.md`).

The repository describes itself as: Comet: agent skill harness for turning ideas into evaluated workflows. The licence is MIT.

When your agent uses it

  • The user invokes /comet
  • Asks to use Comet without choosing Native
  • Classic from project configuration

Example prompts

  • “/comet”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Run the Comet CLI installed on PATH in the current project
  2. Parse the JSON. Only accept schema: comet.workflow-resolution.v1 and one of the two skill values below.
  3. Immediately use the Skill tool to load the entry named by skill. Load exactly one entry

What it can do on your machine

Read from SKILL.md and the folder at commit 0fd42a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    Ships 7 files in scripts/ (JavaScript, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Comet loads about 686 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 359 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~686

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.

Safety

Auto-check passed

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); the scripts in this folder are not scanned.

SKILL.md

The full file from rpamis/comet at commit 0fd42a0, republished under its MIT licence (© rpamis). 359 words, ~686 tokens.

Download SKILL.mdSave it as .claude/skills/comet/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
comet
description
Comet workflow entry. Use when the user invokes /comet or asks to use Comet without choosing Native or Classic; load Native or Classic from project configuration.

Comet Entry

/comet selects Native or Classic from project configuration, then passes the request to that workflow's Skill.

Once this Skill is loaded, immediately follow the steps below. The user has already chosen Comet: continue their request without reconsidering whether to use it or merely explaining why you would not proceed.

  1. Run the Comet CLI installed on PATH in the current project:

    text
    comet workflow resolve . --activate --json

    If the project has no .comet/config.yaml, this command saves the global defaults in the project and creates the configured artifact directories. Later changes to global defaults do not overwrite this project's saved configuration.

    On command not found, executable not found, or ENOENT, stop and report an incomplete Comet CLI installation. Do not search for Skill files, scan platform configuration directories, or invoke an internal bundle directly.

    If the CLI starts but exits nonzero, cannot parse the configuration, or returns invalid JSON or fields, preserve the original error and stop. Do not choose another entry yourself.

  2. Parse the JSON. Only accept schema: comet.workflow-resolution.v1 and one of the two skill values below.

  3. Immediately use the Skill tool to load the entry named by skill. Load exactly one entry:

    • /comet-native → Execute immediately: Use the Skill tool to load the comet-native skill. Do not skip this step.
    • /comet-classic → Execute immediately: Use the Skill tool to load the comet-classic skill. Do not skip this step.

    Pass the user's original request unchanged to that Skill.

Show full SKILL.md (125 more words)Show less

After workflow selection, the selected Skill locates the change's workspace and current phase, then loads task context, personal memory, and project knowledge; use comet memory context when needed.

Load context as needed. First use comet task ... --json to obtain a Context Manifest containing only summaries, reasons for recommending each item, and stable IDs. Add --expand-context "<id>" when the step needs the full text, source, or verification method.

After using an item and establishing its outcome, report the actual result with its returned application ID: --application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure. Do not report successful use of an item that was not used.

Do not switch workflows based on task size, file count, active changes, or model judgment. Native and Classic manage their own changes, state, and artifacts.

© rpamis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 21 other files (scripts) in assets/skills/comet of rpamis/comet.

  • SKILL.md
  • agents/openai.yaml
  • rules/comet-phase-guard.en.md
  • rules/comet-phase-guard.md
  • rules/comet-workflow-guard.en.md
  • rules/comet-workflow-guard.md
  • runtime/classic/checks.yaml
  • runtime/classic/guardrails.yaml
  • runtime/classic/skill.yaml
  • scripts/comet-archive.mjs
  • scripts/comet-check.mjs
  • scripts/comet-entry-runtime.mjs
  • scripts/comet-env.mjs
  • scripts/comet-guard.mjs
  • scripts/comet-handoff.mjs
  • scripts/comet-hook-guard.mjs
  • … and 6 more

Open the folder on GitHubat commit 0fd42a0

Compare with similar skills

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

Comet compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Comet this skillrpamis/comet3.2k—~686Automated safety check: PassMIT
Changelog Entrysickn33/agentic-awesome-skills47k1 repos~1.1kAutomated safety check: PassMIT
Redundant Entrythedaviddias/Front-End-Checklist74k—~520Automated safety check: PassMIT
Write Changelog Entryflet-dev/flet17k—~1.7kAutomated safety check: PassApache-2.0
Cometrpamis/comet3.2k—~363Automated safety check: PassMIT
Cometrpamis/comet3.2k—~2.7kAutomated safety check: PassMIT

Similar skills

  • Changelog Entry

    sickn33/agentic-awesome-skills

    Generate a properly formatted CHANGELOG.md entry in Keep a Changelog format from a commit range or PR.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Redundant Entry

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing any process that spans multiple screens, steps, or modal stages.

    74k GitHub stars~520 tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed
  • A skill your agent uses when asked to add, revise, or review a changelog or release-notes entry in this repo.

    17k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Comet

    rpamis/comet

    Comet 工作流入口。当用户明确调用 /comet,或明确要求使用 Comet 但未指定 Native/Classic 时使用;按项目配置加载 Native 或 Classic。

    3.2k GitHub stars~363 tokensUpdated today
    Auto-check passed
  • Comet

    rpamis/comet

    A skill your agent uses when 用户要启动或恢复 Comet 工作流,需要根据 active change、.comet.yaml、hotfix/tweak 意图路由到对应阶段 Skill。

    3.2k GitHub stars~2.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Comet

    rpamis/comet

    Comet — OpenSpec + Superpowers dual-star development workflow.

    3.2k GitHub stars~4.4k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from rpamis/comet

All 52 skills in this repo
  • Comet Archive

    rpamis/comet

    Archive and deliver a Classic change. An agent skill from rpamis/comet.

    3.2k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Comet Classic

    rpamis/comet

    Comet Classic workflow entry. An agent skill from rpamis/comet.

    3.2k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Comet Design

    rpamis/comet

    Complete the Classic technical design and obtain user confirmation.

    3.2k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Comet Design

    rpamis/comet

    A skill your agent uses when full Comet change 已完成 open 阶段但缺少 Superpowers Design Doc,或 design 阶段需要从 OpenSpec 交接包恢复。

    3.2k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Comet Memory

    rpamis/comet

    A skill your agent uses when Comet must decide whether a bounded semantic review packet contains a personal memory worth creating, updating, forgetting, or skipping.

    3.2k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Comet Native

    rpamis/comet

    Comet Native workflow. An agent skill from rpamis/comet.

    3.2k GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Questions about Comet

What does Comet do?

Comet workflow entry. An agent skill from rpamis/comet. Comet is an agent skill from rpamis/comet. Comet workflow entry.

When should I use Comet?

Comet fits situations like: the user invokes /comet; asks to use Comet without choosing Native; classic from project configuration.

How do I install Comet in Claude Code?

Run `npx skills add rpamis/comet --skill comet -a claude-code`. Or copy the skill folder (assets/skills/comet in rpamis/comet) into .claude/skills/comet in your project. Claude Code loads it when a task matches its description.

How do I install Comet in Codex?

Run `npx skills add rpamis/comet --skill comet -a codex`. Or copy the skill folder (assets/skills/comet in rpamis/comet) into .agents/skills/comet in your project. Codex loads it when a task matches its description.

Can I use Comet in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rpamis/comet --skill comet -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, .gemini/skills/comet, .github/skills/comet and .opencode/skills/comet in your project.

What does Comet need to run?

Going by SKILL.md and its folder, Comet needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Comet access the network?

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.

Is Comet safe to install?

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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Comet use?

Comet is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Comet use?

About 686 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Comet?

Skills that share tags, products or a category with Comet: Changelog Entry (sickn33/agentic-awesome-skills, 47k stars), Redundant Entry (thedaviddias/Front-End-Checklist, 74k stars), Write Changelog Entry (flet-dev/flet, 17k stars) and Comet (rpamis/comet, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Comet?

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.