openspec-install
Install the OpenSpec CLI globally via npm, pnpm, yarn, bun, or nix. Use when the user says "install OpenSpec", "set up OpenSpec", or "openspec command not found".
How do I install this agent skill?
npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-installIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides standard instructions for installing the OpenSpec CLI globally using common package managers (npm, pnpm, yarn, bun) and Nix. The packages are sourced from the official Fission-AI scoped package on npm and their public GitHub repository. No security risks or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
OpenSpec Install Skill
Install the OpenSpec CLI so that openspec is available globally. This skill covers only installing the CLI; it does not run openspec init. For project initialization after install, use openspec-initial.
When to Use
- First-time OpenSpec setup ("install OpenSpec", "get started with OpenSpec").
- User reports "openspec: command not found".
- Upgrading to the latest version.
- CI or scripts that need the CLI pre-installed.
Prerequisites
- Node.js 20.19.0 or higher — Check with
node --version. If not installed, guide the user to install Node.js first (e.g. via nvm, fnm, or official installer).
Workflow
-
Check if already installed
- Run
openspec --version. If it succeeds, the CLI is already installed; suggest openspec-initial for project setup or upgrading vianpm install -g @fission-ai/openspec@latest.
- Run
-
Choose package manager and install
- npm (most common):
npm install -g @fission-ai/openspec@latest - pnpm:
pnpm add -g @fission-ai/openspec@latest - yarn:
yarn global add @fission-ai/openspec@latest - bun:
bun add -g @fission-ai/openspec@latest - nix (one-time, no install):
nix run github:Fission-AI/OpenSpec -- init - nix (persistent):
nix profile install github:Fission-AI/OpenSpec
- npm (most common):
-
Verify installation
- Run
openspec --versionto confirm.
- Run
-
Upgrade existing installation
- Same command as install — e.g.
npm install -g @fission-ai/openspec@latest.
- Same command as install — e.g.
Outputs
openspeccommand available globally in PATH.
Next Steps
- Use openspec-initial to run
openspec initin a project. - Or use openspec-onboard for a guided tutorial.
Different Environments
| Environment | Command |
|---|---|
| npm | npm install -g @fission-ai/openspec@latest |
| pnpm | pnpm add -g @fission-ai/openspec@latest |
| yarn | yarn global add @fission-ai/openspec@latest |
| bun | bun add -g @fission-ai/openspec@latest |
| nix (one-time) | nix run github:Fission-AI/OpenSpec -- init |
| nix (persistent) | nix profile install github:Fission-AI/OpenSpec |
| CI | npm install -g @fission-ai/openspec@latest in a cacheable step |
Troubleshooting
- Node.js version too old: OpenSpec requires Node.js 20.19.0+. Upgrade Node.js first.
- Permission errors (npm): Use
npm install -gwithout sudo if using nvm/fnm; otherwise consider using nvm. - Command not found after install: Ensure the global bin directory is in PATH (check
npm bin -g). - nix not available: Install nix or use npm/pnpm/yarn/bun instead.
References
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/full-stack-skills/openspec-skills/openspec-install">View openspec-install on skillZs</a>