SafeSkill CLI Docs

Prerequisites

• Node.js 18 or newer
• Network access to your Skill sources

node -v
npx safeskill --version

Getting started

npx safeskill --help

npm i -g @safeskill/cli
safeskill --help

First install

npx safeskill add example-org/agent-skills

Command cheat sheet

Source formats

npx safeskill add owner/repo
npx safeskill add https://github.com/owner/repo
npx safeskill add https://gitlab.com/group/repo
npx safeskill add ./my-skills
npx safeskill add safeskill://official/acme/code-review@1.2.0

Common flags

add: -g global, -a <agent> target agents, -s <skill> pick Skill, -l list only, -y yes, --all, --copy

remove: -g, -a, -y, --all

list: -g, -a, --json

Typical workflows

npx safeskill add owner/repo --list
npx safeskill add owner/repo --skill code-review -y
npx safeskill add owner/repo -a claude-code -a codex -y
npx safeskill add owner/repo -g -y
npx safeskill check && npx safeskill update
npx safeskill remove my-skill -y

Hub server (enterprise)

export SAFESKILL_HUB_URL=https://hub.example.com
npx safeskill add safeskill://official/acme/code-review@1.2.0

Troubleshooting

No skills found — invalid or missing SKILL.md, or front matter without name / description.

Permission errors — check write access; on Windows try --copy for symlink limits.

Agent flag ignored — ensure the agent is installed; re-run add with -a <agent>.

Security tips

• Install only from trusted sources
• Prefer --list then --skill for precise installs
• In CI, combine -y with fixed --agent and --skill

-a agent parameter values