Agent skill

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

View SKILL.md on GitHub Repository
Stars 254
Forks 41

Install this agent skill to your Project

npx add-skill https://github.com/partme-ai/full-stack-skills/tree/main/skills/openspec-skills/openspec-install

SKILL.md

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

  1. Check if already installed

    • Run openspec --version. If it succeeds, the CLI is already installed; suggest openspec-initial for project setup or upgrading via npm install -g @fission-ai/openspec@latest.

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

  3. Verify installation

    • Run openspec --version to confirm.

  4. Upgrade existing installation

    • Same command as install — e.g. npm install -g @fission-ai/openspec@latest.

Outputs

  • openspec command available globally in PATH.

Next Steps

  • Use openspec-initial to run openspec init in 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 -g without 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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

partme-ai/full-stack-skills

ocrmypdf-batch

OCRmyPDF batch processing skill — process multiple PDFs, Docker automation, shell scripting, and CI/CD integration. Use when the user needs to OCR many PDFs, set up automated OCR pipelines, or integrate OCR into workflows.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-optimize

OCRmyPDF optimization skill — compress PDFs, configure PDF/A output, JBIG2 encoding, and lossless optimization. Use when the user needs to reduce PDF file size, create archival PDF/A files, or optimize OCR output.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-image

OCRmyPDF image processing skill — deskew, rotate, clean, despeckle, remove border from scanned documents. Use when the user needs to improve scanned PDF quality, fix skewed pages, remove noise, or clean up scanned documents before OCR.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf-api

OCRmyPDF Python API and plugin skill — use OCRmyPDF programmatically from Python, integrate with applications, and extend with plugins (EasyOCR, PaddleOCR, AppleOCR). Use when the user needs to call OCRmyPDF from Python code, build OCR pipelines, or use alternative OCR engines.

254 41
Explore
partme-ai/full-stack-skills

ocrmypdf

OCRmyPDF core skill — add searchable OCR text layer to scanned PDFs, convert images to searchable PDFs, support 100+ languages via Tesseract. Use when the user needs to OCR a PDF, make a scanned PDF searchable, or extract text from scanned documents.

254 41
Explore
partme-ai/full-stack-skills

svelte

Guides Svelte and SvelteKit development including reactive components, stores, transitions, lifecycle hooks, SSR, file-based routing, and deployment. Use when the user needs to build Svelte components, create SvelteKit applications, implement reactivity patterns, or configure Svelte with Vite.

254 41
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results