Openspec cli

Skill TheSmuks/openspec-hermes/skills/openspec/openspec-cli

Use when working with OpenSpec in Hermes: manage OpenSpec CLI setup, validation, browsing, workspaces, context stores, initiatives, and shell integration.From its SKILL.md

Install

npx -y skills add TheSmuks/openspec-hermes --skill openspec-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.9 KB, 623 tokens by cl100k_base, as published. Nobody here has run it

openspec-cli

Use for OpenSpec CLI administration and non-workflow features.

Hermes operating rules for OpenSpec

Work from the user's project root. If unknown, inspect the current directory first.
Ensure the OpenSpec CLI exists before using it: openspec --version. If missing, install with npm install -g @fission-ai/openspec@latest.
Initialize projects with openspec init --tools none unless the user also wants other AI-tool integrations. Hermes uses these skills, not OpenSpec-generated slash commands.
Prefer agent-compatible OpenSpec CLI calls with --json where available: openspec list --json, openspec status --change <id> --json, openspec instructions <artifact> --change <id> --json, openspec validate --all --json.
Read generated artifacts before editing or implementing. Do not invent OpenSpec state.
Run validation after changing OpenSpec artifacts: openspec validate <change> or openspec validate --all.
Keep changes focused. If user scope diverges, update the existing change only when intent is the same; otherwise create a new change.

Setup and update

Install/upgrade: npm install -g @fission-ai/openspec@latest
Init project for Hermes: openspec init --tools none
Refresh OpenSpec-generated files if the user uses other tools too: openspec update

Agent-compatible inspection

openspec list --json
openspec list --specs --json
openspec show <item> --json
openspec validate --all --json
openspec status --change <id> --json
openspec instructions <artifact> --change <id> --json
openspec templates --json
openspec schemas --json

Workspaces and shared context

openspec workspace setup --no-interactive --name <name> --link <path> --json
openspec workspace list --json
openspec workspace link <name> <path> --json
openspec workspace doctor --json
openspec workspace update --tools none
openspec workspace open --editor or --agent <tool>
openspec context-store setup <id> --json --no-init-git
openspec context-store register <path> --json
openspec context-store list --json
openspec context-store doctor <id> --json
openspec initiative create <id> --title <title> --summary <summary> --json
openspec initiative list --json
openspec initiative show <id> --json

Completion and feedback

Shell completions: openspec completion install bash|zsh|fish|powershell
Feedback: openspec feedback "message" --body "details" requires gh auth.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.