Skip to content
Docs: CLI reference

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:

  1. SKILLIFY_TOKEN in the environment.
  2. ~/.config/skillify/credentials.json, written by login (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.

Flags of sync
FlagWhat it does
--dry-runPrint what would change and write nothing.
--forceOverwrite skills edited in the repo. Their edits are lost.
--verboseList 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.

Flags of status
FlagWhat it does
--checkExit 1 unless every skill is current. For CI.
--jsonPrint the states as JSON.
--no-remoteOnly 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

Environment
VariableWhat it does
SKILLIFY_TOKENA personal token, used instead of the saved one.
NO_COLORPlain output with no colours.