In your repos
CLI reference
The CLI lives in each repo as .skillify/cli.mjs: one file, no dependencies, Node.js 20 or newer.
On this page
Run it from anywhere inside the repo as node .skillify/cli.mjs <command>. It finds the repo root itself.
Signing in
Commands that talk to Skillify as you (sync, init, status comparing with the server) use a personal token, looked up in this order:
SKILLIFY_TOKENin the environment.~/.config/skillify/credentials.json, written bylogin(readable only by you).
The ingest key in .skillify/config.json is not a token: it can only report status and usage.
Commands
node .skillify/cli.mjs sync [--dry-run] [--force] [--verbose]
Writes the repo’s skills, AGENTS.md block and lock file to match Skillify, then reports what is on disk.
| Flag | What it does |
|---|---|
--dry-run | Print what would change and write nothing. |
--force | Overwrite skills edited in the repo. Their edits are lost. |
--verbose | List every file written, not just a summary. |
node .skillify/cli.mjs status [--check] [--json]
Shows each skill’s state: current, edited here, missing, behind, new or removed.
| Flag | What it does |
|---|---|
--check | Exit 1 unless every skill is current. For CI. |
--json | Print the states as JSON. |
--no-remote | Only check local edits; do not ask Skillify what is new. |
node .skillify/cli.mjs login [--token sk_…]
Saves a personal token for this repo’s Skillify server. Without --token it asks for one.
node .skillify/cli.mjs doctor
Checks the config, the token, the connection to the server and the usage hook, and says what to fix.
node .skillify/cli.mjs init [owner/name] --server <url>
Sets up a repo that has no .skillify/ yet. Needs a token. Defaults the name to the git remote.
node .skillify/cli.mjs install --server <url> --install-token <token>
What the install link runs. You rarely call it yourself.
node .skillify/cli.mjs hook
The Claude Code usage hook. Reads the hook’s JSON on stdin and reports one use; always exits 0.
Environment
| Variable | What it does |
|---|---|
SKILLIFY_TOKEN | A personal token, used instead of the saved one. |
NO_COLOR | Plain output with no colours. |