Installation

System Requirements

Requirement	Minimum	Recommended
Node.js	18.0+	22.x LTS
npm	9.0+	11.x
OS	macOS, Linux, Windows	macOS, Linux

Install via npm

npm install -g skill-forge

Install via npx (no global install)

You can also run skill-forge without installing globally:

npx skill-forge create my-skill
npx skill-forge validate
npx skill-forge publish

Verify Installation

skill-forge --version
# skill-forge v1.0.0

skill-forge --help
# Available commands:
#   create <name>   Create a new skill from a template
#   validate        Validate the current skill
#   publish         Publish to the skill registry
#   list            List available templates

Shell Completion

Enable tab completion for your shell:

# Bash
skill-forge completion bash >> ~/.bashrc

# Zsh
skill-forge completion zsh >> ~/.zshrc

# Fish
skill-forge completion fish > ~/.config/fish/completions/skill-forge.fish

Updating

npm update -g skill-forge

Troubleshooting

Permission Errors on macOS/Linux

If you get EACCES errors, fix npm’s global directory permissions:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Behind a Proxy

npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080
npm install -g skill-forge