CLI Reference

Install and manage agent skills without leaving your terminal.

npx @skillz.supply/cli --help

publish

npx @skillz.supply/cli publish [path]

Publish local SKILL.md files to your AT Protocol repo.

The path may be a SKILL.md, a skill directory, or a skills directory. Without a path, .skillz.json is used.

--yes

Publish all discovered skills without prompts.

--dry-run

Validate and show what would publish without logging in or writing.

install

npx @skillz.supply/cli install <ref>

Install an agent skill into the current project.

<ref> is a DID/rkey reference or a full skillz.supply SKILL.md URL. The first interactive install remembers the destination in .skillz.json.

--dir <path>

Write skills under this directory and skip the destination prompt.

--force

Overwrite an existing skill with the same name.

--yes

Run non-interactively; requires --dir when no destination is configured.

login

npx @skillz.supply/cli login [handle-or-did]

If the identifier is omitted, the CLI prompts for it. It then opens a browser for authorization and stores the session in the operating system credential store.

logout

npx @skillz.supply/cli logout

Revoke and remove the saved OAuth session.

whoami

npx @skillz.supply/cli whoami

Show the DID for the currently authenticated account.