CLI Reference

Complete reference for the skill7 command-line tool.

Usage: skill7 <command> [args] [flags]

install

Install a plugin from the registry

skill7 install <name> [flags]

Fetches the named plugin from the registry and installs it for all detected AI CLIs. Auto-detects Claude Code, Codex CLI, and Gemini CLI in your PATH.

Flag	Description
--claude-code	Install only for Claude Code
--codex	Install only for Codex CLI
--gemini	Install only for Gemini CLI
--version <ver>	Pin to a specific version (default: latest)

$ skill7 install herald

$ skill7 install signum --claude-code

$ skill7 install arbiter --version 1.2.0

uninstall

Remove an installed plugin

skill7 uninstall <name>

Removes the plugin from all CLIs it was installed for.

$ skill7 uninstall herald

list

List installed plugins

skill7 list [flags]

Shows all currently installed plugins, their versions, and which CLIs they are active for.

Flag	Description
--json	Output as JSON (machine-readable)
--outdated	Show only plugins with available updates

check

Verify plugin integrity

skill7 check [<name>]

Verifies SHA-256 checksums of installed plugin files against the registry manifest. Checks all installed plugins if no name is given.

update

Update installed plugins

skill7 update [<name>] [flags]

Fetches and installs the latest version of a plugin, or all installed plugins if no name is given.

Flag	Description
--dry-run	Show what would be updated without applying

$ skill7 update

$ skill7 update herald

publish

Publish a plugin to the registry

skill7 publish [flags]

Packages and submits the plugin in the current directory to the skill7 registry. Requires a valid plugin.json and a skills/ directory.

Flag	Description
--tag <ver>	Version tag to publish (default: from plugin.json)
--dry-run	Validate and package without submitting

dev link / unlink

Link a local plugin for development

skill7 dev link [<path>]

skill7 dev unlink [<name>]

dev link installs the plugin from a local path into your AI CLIs for testing. Changes to the source directory are reflected immediately (no reinstall required). dev unlink removes the local link.

$ skill7 dev link ./my-plugin

$ skill7 dev unlink my-plugin

init

Scaffold a new plugin

skill7 init <name> [flags]

Creates a new plugin directory with plugin.json, a skills/ directory, and a starter skill file.

Flag	Description
--template <name>	Scaffold from a named template (default: minimal)

$ skill7 init my-plugin

convert

Convert a plugin from another format

skill7 convert <source> [flags]

Converts a plugin from an existing format (e.g., a Claude Code plugin installed via claude plugin) into the skill7 registry format.

Flag	Description
--out <dir>	Output directory (default: ./)

Browse registry Getting Started