Reference on SkillsCtl

skillsctl

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl#

Discover, install, and publish Claude Code skills

Synopsis#

skillsctl is the CLI for the SkillsCtl skill registry. Use it to browse and install skills published by your team or organization, and to publish your own. Skills install into ~/.claude/skills/ by default and are picked up automatically by Claude Code at session start.

Options#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)
 -h, --help help for skillsctl

skillsctl auth

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl auth#

Manage authentication with the registry

Options#

 -h, --help help for auth

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl auth login

Mon, 01 Jan 0001 00:00:00 +0000

Authenticate with the registry via OIDC device flow

Synopsis#

Start an OIDC device authorization flow against the registry’s configured identity provider. The CLI prints a URL and a user code; open the URL in any browser, enter the code, and approve. The resulting tokens are cached at ~/.config/skillsctl/credentials.json (or the path passed to –credentials-path) and refreshed automatically on subsequent commands.

If the server is running without OIDC configured, this command prints a notice and exits successfully without writing credentials.

skillsctl auth logout

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl auth logout#

Remove cached credentials

skillsctl auth logout [flags]

Examples#

 skillsctl auth logout

Options#

 -h, --help help for logout

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl auth status

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl auth status#

Show the active identity and token expiry

skillsctl auth status [flags]

Examples#

 skillsctl auth status

Options#

 -h, --help help for status

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl config

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl config#

Manage the local skillsctl configuration file

Synopsis#

Read and write ~/.config/skillsctl/config.yaml. Recognized keys are api_url (the registry URL the CLI talks to) and skills_dir (where ‘install’ writes downloaded skills).

Options#

 --config-path string Config file path (for testing)
 -h, --help help for config

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl config get

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl config get#

Print a single config value

skillsctl config get <key> [flags]

Examples#

 skillsctl config get api_url

Options#

 -h, --help help for get

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --config-path string Config file path (for testing)
 --credentials-path string Credentials file path (for testing)

skillsctl config init

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl config init#

Interactive first-time setup; prompts for api_url and skills_dir

skillsctl config init [flags]

Examples#

 skillsctl config init

Options#

 --force Overwrite an existing config file
 -h, --help help for init

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --config-path string Config file path (for testing)
 --credentials-path string Credentials file path (for testing)

skillsctl config list

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl config list#

Print every recognized config value

skillsctl config list [flags]

Examples#

 skillsctl config list

Options#

 -h, --help help for list

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --config-path string Config file path (for testing)
 --credentials-path string Credentials file path (for testing)

skillsctl config set

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl config set#

Set a config value (api_url or skills_dir)

skillsctl config set <key> <value> [flags]

Examples#

 skillsctl config set api_url https://skillsctl.example.com

Options#

 -h, --help help for set

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --config-path string Config file path (for testing)
 --credentials-path string Credentials file path (for testing)

skillsctl explore

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl explore#

Browse available skills

skillsctl explore [flags]

Examples#

 # List every skill in the registry
 skillsctl explore

 # Filter by tag (repeatable; matches any)
 skillsctl explore --tag go --tag testing

 # Only show skills published directly to this registry
 skillsctl explore --source internal

Options#

 -h, --help help for explore
 --source string Filter by source: internal, external, or all (default "all")
 --tag strings Filter by tag; repeat to match any of several tags

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl explore show

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl explore show#

Show skill details and version history

skillsctl explore show <name> [flags]

Examples#

 # Metadata and version history
 skillsctl explore show git-commit

 # Include the rendered SKILL.md content
 skillsctl explore show git-commit --verbose

Options#

 -h, --help help for show
 -v, --verbose Include the SKILL.md content (multi-file skills are extracted first)

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl install

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl install#

Install a skill from the registry

Synopsis#

Download a skill from the registry and write it to the local skills directory.

By default skills install to the directory configured as skills_dir (typically ~/.claude/skills). Use –project to install into a specific project’s .claude/skills/ instead, or –skills-dir to override the target for a single invocation.

skillsctl install <name[@version]> [flags]

Examples#

 # Install the latest version
 skillsctl install git-commit

 # Pin a version and verify the digest
 skillsctl install git-commit@1.2.0 --digest sha256:abc123...

 # Install into the current project (writes to ./.claude/skills/)
 skillsctl install git-commit --project

 # Install into a specific project directory
 skillsctl install git-commit --project /path/to/repo

Options#

 --digest string Expected content digest in sha256:... form; install aborts if the downloaded content does not match
 --force Overwrite an existing skill directory
 -h, --help help for install
 --project string[="."] Install to <path>/.claude/skills; when used without a value, installs into the current directory
 --skills-dir string Override the configured skills directory for this install

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

skillsctl publish

Mon, 01 Jan 0001 00:00:00 +0000

skillsctl publish#

Publish a skill to the registry

Synopsis#

Package a skill directory and upload it to the registry.

The directory passed via –dir must contain SKILL.md at its root; subdirectories (scripts/, references/, assets/) are packaged and preserved on install. Versions are immutable once published, so each publish must use a new –version.

skillsctl publish [flags]

Examples#

 # Publish the first version of a skill
 skillsctl publish \
 --name git-conventional \
 --version 1.0.0 \
 --description "Enforce conventional commit messages" \
 --dir ./git-conventional

 # Publish with tags and a changelog
 skillsctl publish \
 --name git-conventional \
 --version 1.1.0 \
 --description "Enforce conventional commit messages" \
 --dir ./git-conventional \
 --tag git --tag commits \
 --changelog "Add breaking-change detection"

Options#

 --changelog string Release notes for this version
 --description string Short description shown in 'skillsctl explore'
 --dir string Path to the skill directory; must contain SKILL.md at its root
 -h, --help help for publish
 --name string Skill name (lowercase, 2-64 chars, alphanumeric and hyphens)
 --tag strings Tag for filtering in 'explore' (repeatable)
 --version string Semantic version, e.g. 1.0.0; must be unique for this skill

Options inherited from parent commands#

 --api-url string Registry URL; overrides the api_url setting from config and SKILLCTL_API_URL
 --credentials-path string Credentials file path (for testing)

Reference on SkillsCtl

skillsctl

skillsctl#

Synopsis#

Options#

SEE ALSO#

skillsctl auth

skillsctl auth#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl auth login

skillsctl auth login#

Synopsis#

skillsctl auth logout

skillsctl auth logout#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl auth status

skillsctl auth status#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl config

skillsctl config#

Synopsis#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl config get

skillsctl config get#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl config init

skillsctl config init#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl config list

skillsctl config list#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl config set

skillsctl config set#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl explore

skillsctl explore#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl explore show

skillsctl explore show#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl install

skillsctl install#

Synopsis#

Examples#

Options#

Options inherited from parent commands#

SEE ALSO#

skillsctl publish

skillsctl publish#

Synopsis#

Examples#

Options#