Skip to content

CLI

skilly provides commands for managing Agent Skills in interactive terminals and non-interactive automation.

Global options

Option Description
-h, --help Print help for the command
-V, --version Print the installed version

Command overview

Command Purpose
create Create a specification-compliant skill.
scan Scan dependencies for skills from pyproject.toml, package.json, and pom.xml.
download Download one or more skills from a supported repository URL.
list Browse, update, or remove installed skills.
update Check installed skill updates in bulk and optionally apply them.
remove Remove one installed skill by directory name.
skillsmp search Search SkillsMP and install a selected result.
skillsmp list Browse installed SkillsMP skills and manage updates.
util dependencies Print dependency names resolved from pyproject.toml.
util venv List skills discovered inside a virtual environment.
configure Manage directories and repository credentials.

Destination options

Every management command (scan, download, list, update, remove, create, skillsmp search, skillsmp list) accepts destination flags:

Flag Resolved path
(none) $SKILLY_DEFAULT_DIRECTORY or .agents/skills
--local .agents/skills
--global ~/.agents/skills
--claude .claude/skills
--claude --global ~/.claude/skills
--codex .codex/skills
--codex --global ~/.codex/skills
--copilot .github/skills
--copilot --global ~/.copilot/skills
--directory <path> Literal path (after ~ expansion)

--directory overrides all other destination flags and SKILLY_DEFAULT_DIRECTORY.

Workflow guides