comet-skills

Comet's shared skills for AI coding agents — Claude Code, Codex, and the cross-runtime trio (Copilot CLI / Gemini CLI). One CLI, one registry, add what you need:

npx comet-skills add flutter-clean-architecture

It detects which agents are set up in your project (Claude Code, Codex, …) and installs the skill into each. Then tell your agent to use it; it loads the skill by its description.

Why

A skill (SKILL.md + frontmatter) is the Agent Skills format that multiple agents read. comet-skills is a tiny installer (shadcn-style "registry + CLI") that drops a chosen skill into the right folder for each agent so you don't copy files by hand.

Install a skill

npx comet-skills add flutter-clean-architecture

No flags needed. It checks which agents are set up in the current project and installs only into those:

| If the project has… | Skill installs into | |---|---| | .claude (Claude Code) | ./.claude/skills/ | | .codex (Codex) | ./.codex/skills/ | | .agents (Copilot / Gemini) | ./.agents/skills/ |

If none are found, it defaults to Claude Code (./.claude/skills/). Use --global to install into your home (~/) for every project, and --force to overwrite. Restart the agent session to load a newly-added skill.

Available skills

npx comet-skills list

| Skill | What it teaches | |---|---| | flutter-clean-architecture | Flutter clean architecture + Cubit conventions, plus greenfield project scaffolding |

(Go, Nest, and more land here as new registry entries.)

Repo layout

comet-skills/
├── package.json          # the published CLI (bin: comet-skills)
├── registry.json         # index: skill name, files, and the raw-GitHub baseUrl
├── bin/cli.js            # `add` / `list`
├── lib/
│   ├── registry.js       # load registry, local-vs-remote resolution
│   └── install.js        # agent auto-detect + installer
└── skills/
    └── <skill-name>/      # SKILL.md (+ reference files) — the registry content

The CLI fetches skill files from registry.json's baseUrl (raw GitHub) when run via npx, and reads skills/ directly when run inside this checkout (dev).

Add a new skill to the registry (e.g. Go, Nest)

1. Create skills/<skill-name>/SKILL.md (+ any reference files). Follow Anthropic's skill-authoring best practices: a third-person Use when… description (triggers only, no workflow summary), a quick-reference table, one strong example per pattern, and reference files kept one level deep. Keep it agent-agnostic so it works in Claude Code and Codex.
2. Add an entry to registry.json (name, title, description, and the list of files).
3. Test locally: node bin/cli.js add <skill-name> --project --force.
4. Commit + push. Teammates get it via npx comet-skills add <skill-name>.

Publish the CLI (later)

npm publish        # public package (publishConfig.access = public)

Until published, run from the repo (node bin/cli.js …) or npx github:cometdigitalagency/comet-skills add <skill>.

License

MIT