teachingai/openspec-install
skills/openspec-skills/openspec-install/SKILL.md
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".
$ install --global
skillsauthnpx skillsauth add teachingai/agent-skills openspec-installInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 8:59 AM161.3s4 files scanned
SKILL.md
- name:
- openspec-install
- description:
- 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".
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
- OpenSpec Installation docs
- OpenSpec GitHub
Related Skills
teachingai/nextjs
development
VerifiedTrustedCommunity
Guidance for Next.js using the official docs at nextjs.org/docs. Use when the user needs Next.js concepts, configuration, routing, data fetching, or API reference details.
284SKILL.mdUpdated Apr 14, 2026
teachingai/flask
tools
VerifiedTrustedCommunity
Provides comprehensive guidance for Flask framework including routing, templates, forms, database integration, extensions, and deployment. Use when the user asks about Flask, needs to create web applications, implement routes, or build Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/fastapi
development
VerifiedTrustedCommunity
Provides comprehensive guidance for FastAPI framework including routing, request validation, dependency injection, async operations, OpenAPI documentation, and database integration. Use when the user asks about FastAPI, needs to create REST APIs, or build high-performance Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/django
development
VerifiedTrustedCommunity
Provides comprehensive guidance for Django framework including models, views, templates, forms, admin, REST framework, and deployment. Use when the user asks about Django, needs to create web applications, implement models and views, or build Django REST APIs.
284SKILL.mdUpdated Apr 14, 2026