cli-skills (0.10.9)
Install and update LLM agent skills for supported CLI tools.
Manage user-level skills for antigravity, claude, codex, copilot, opencode, openclaw, and pi.
Feature Highlights | Skill Layout | Quick Start | Commands | CLI Targets | Install Behavior | Configuration | Release Checks | Upgrade and Uninstall | Live execution with uvx | Local Execution | Development | Acknowledgments
🚧 DRAFT: Proof-of-Concept (PoC) Version 📝 - Work in Progress 🏗️ 🚧
⚠️ IMPORTANT NOTICE: Created with PI-useReq/pi-usereq 🤖✨ ⚠️
Feature Highlights
- Install bundled skills into each enabled CLI's user-level skills directory.
- Synchronize managed skill directories on every install: packaged files are overwritten and files no longer packaged are deleted.
- Enable or disable each target CLI; the selection persists in
~/.config/cli-skills/config.json. - Inspect packaged resources, CLI configuration, and installation status with
show. - Inspect and mutate the configuration with
--print,--info,--print-raw,--get,--set, and--unset. - Check PyPI releases automatically with a 2-second timeout and a cached idle delay;
--veralso reports the latest GitHub release. - Install the bundled skills automatically after a successful
--upgradewhen at least one CLI is enabled. - Run from a repository checkout, as a uv tool, or with uvx; the
skillsexecutable accepts the same commands and options ascli-skills.
Bundled skills:
astra-uv-project- create a new Astral uv Python CLI project from scratch.prompt-skill-architect- create, review, and optimize LLM agent prompts and skills.
All bundled skills are listed in the packaged manifest src/resources/manifest.json.
Skill Support Layout
Each packaged skill keeps SKILL.md at its root and organizes support files by purpose:
<skill-name>/
├── SKILL.md
├── scripts/
│ └── <script-name>.sh
├── references/
│ ├── images/
│ │ └── <picture-name>.png
│ └── <reference-template-name>.md
├── images/
│ └── <picture-name>.svg
└── assets/
└── <data-or-configuration-name>.json
scripts/contains shell and Python scripts.references/contains Markdown support files;references/images/contains images referenced by those files.assets/contains data and configuration files.images/contains vector or raster images referenced bySKILL.md.
Quick Start
Prerequisites: Python 3.11 or newer and Astral uv.
-
Install the CLI:
uv tool install cli-skills
-
Enable one or more target CLIs:
cli-skills enable pi cli-skills enable claude
-
Install the bundled resources:
cli-skills install -
Start or restart the target CLI so it discovers the installed skills.
-
Optional: review packaged resources, CLI configuration, and installation status:
cli-skills show
enable and disable persist their selection; install updates every enabled CLI.
Commands
| Command | Behavior |
|---|---|
cli-skills |
Print the full help screen. |
cli-skills --help |
Print the full help screen. |
cli-skills <command> --help |
Print help for enable, disable, install, uninstall, show, --upgrade, --uninstall, --ver, --version, --dev, --force, or any configuration command. |
cli-skills --ver |
Print the Current Installed, Latest @ PyPI, and Latest @ GitHub lines; force a release check. |
cli-skills --version |
Same as --ver. |
cli-skills --upgrade |
Upgrade from PyPI with uv on Linux, then install bundled skills for every enabled CLI; print the manual command on other platforms. |
cli-skills --upgrade --dev |
Upgrade to the latest tagged GitHub release instead of PyPI (Linux); print the manual command elsewhere. |
cli-skills --upgrade --develop |
Long form of --upgrade --dev. |
cli-skills --upgrade --force |
Force download and complete reinstallation from PyPI with --force --reinstall --refresh (Linux); print the manual command elsewhere. |
cli-skills --upgrade --dev --force |
Force download and complete reinstallation of the latest tagged GitHub release (Linux); print the manual command elsewhere. |
cli-skills --uninstall |
Uninstall the tool with uv on Linux; print the manual command on other platforms. |
cli-skills enable <cli name> |
Enable skill installation for a supported CLI. |
cli-skills disable <cli name> |
Disable skill installation for a supported CLI. |
cli-skills install |
Install or update bundled skills for every enabled CLI. |
cli-skills uninstall |
Remove installed bundled skills for every enabled CLI. |
cli-skills show |
Show packaged resources, CLI configuration, and installation status. |
cli-skills --print [<path>] |
Print the configuration tree or one configuration subtree. |
cli-skills --info [<path>] |
Print the configuration schema reference or one schema subtree. |
cli-skills --print-raw |
Print the raw configuration JSON file bytes. |
cli-skills --get <path> |
Print the JSON value stored at a canonical configuration path. |
cli-skills --set <path> <value> |
Validate and store a value at a canonical configuration path. |
cli-skills --unset <path> |
Reset a value to its default or delete one array item at a canonical configuration path. |
--dev, --develop, and --force are --upgrade options only. The skills executable exposes the same commands, output, and exit codes as cli-skills.
Exit codes:
0- success, including help, version reporting, andinstalloruninstallwith no enabled CLI.1- configuration command failure, installation or uninstallation failure for at least one enabled CLI, or chained post-upgrade install failure.2- unknown command or option, unsupported CLI name, missing CLI name, or an invalid--upgradeoption combination.- Any other nonzero status returned by uv for
--upgradeor--uninstall.
Supported CLI Targets
| CLI | Skills directory |
|---|---|
antigravity |
~/.gemini/config/skills |
claude |
~/.claude/skills |
codex |
~/.codex/skills |
copilot |
~/.copilot/skills |
opencode |
~/.config/opencode/skills |
openclaw |
~/.openclaw/workspace/skills |
pi |
~/.pi/agent/skills |
Only enabled CLIs are updated. Destinations are user-level configuration directories, not project directories.
Install Behavior
installprocesses every enabled CLI.- Each packaged skill is copied to
<skills directory>/<skill name>. - Existing skill files are overwritten with the packaged versions.
- Files and directories inside a managed skill directory that are absent from the package are deleted.
- Skill directories not managed by the package are left unchanged.
- A missing packaged source path aborts that CLI and reports an error; remaining enabled CLIs are still processed.
- Output reports
Installed <n> skills for <cli>.followed by an indentedSkills: <names>line for each processed CLI. - With no enabled CLI,
installprints an informational message and exits with0. - If any CLI installation fails,
installprints the error and exits with1. uninstalldeletes<skills directory>/<skill name>for every manifest skill and every enabled CLI, reportsRemoved <n> skills for <cli>.per CLI, and preserves destination entries outside managed skill directories.- A missing destination skill directory counts as removed; with no enabled CLI,
uninstallprints an informational message and exits with0. - If any CLI uninstallation fails,
uninstallprints the error, continues with the remaining enabled CLIs, and exits with1.
Configuration
The CLI stores its user configuration at:
~/.config/cli-skills/config.json
Example:
{
"enabled": [
"pi",
"claude"
]
}
The file root is the canonical section Global; its only key is enabled, a unique array of supported CLI names whose default is the empty array. enable and disable maintain enabled through the same schema used by the configuration commands.
Configuration commands:
| Command | Behavior |
|---|---|
cli-skills --print [<path>] |
Print the whole configuration tree or the requested subtree. |
cli-skills --info [<path>] |
Print the whole schema reference or the requested schema subtree, including types, constraints, defaults, and allowed values. |
cli-skills --print-raw |
Print the unmodified on-disk configuration bytes. |
cli-skills --get <path> |
Print exactly one JSON value without labels. |
cli-skills --set <path> <value> |
Validate and store one value. |
cli-skills --unset <path> |
Reset a value declaring a default or delete one array item. |
Canonical paths are case-sensitive and colon-separated, rooted at Global; use Global:enabled for the enabled array. Arrays address an item with <Idx> and accept +, append, or insert:<Idx> for additions.
cli-skills --print
cli-skills --info
cli-skills --get Global:enabled
cli-skills --set Global:enabled '["claude","pi"]'
cli-skills --set Global:enabled:+ pi
cli-skills --unset Global:enabled:0
cli-skills --unset Global
- A whole-array argument is a JSON array such as
'["claude","pi"]'; a single array item is literal text such aspi. - Valid output goes to stdout; every configuration diagnostic goes to stderr with exit status
1. --setand--unsetvalidate the whole resulting configuration, then replace the file atomically; a failed operation leaves the stored configuration unchanged and prints no success line.- A successful
--setprintsSet <path>.; a successful--unsetprintsUnset <path>.. --print,--print-raw,--get,--set, and--unsetinitialize a missing configuration file from schema defaults;--inforeads only the schema.- Read commands tolerate a missing, unreadable, or malformed file;
--setand--unsetreject malformed or schema-invalid content. - Unknown sections, unknown keys, unknown operations, invalid indices, and out-of-range indices are rejected with a diagnostic naming the path and, for indices, the valid range.
Release Checks
-
A release check runs before command dispatch on every invocation.
-
The check requests the latest published version from the PyPI JSON API with a 2-second timeout.
-
Cache file:
~/.cache/cli-skills/check_version_idle-time.json, storing last-success and idle-time timestamps in epoch and human-readable form. -
The check is skipped while the cached idle time is valid.
-
A newer release prints a bright-green available-versus-installed message and sets a 3600-second idle delay.
-
A failed check prints a bright-red error message and sets an 86400-second idle delay.
-
A check that finds no newer release prints nothing and sets an 86400-second idle delay.
-
--verand--versionforce a check and print three aligned lines:Current Installed : x.y.z Latest @ PyPI : x.y.z Latest @ GitHub : x.y.z
-
A failed PyPI request prints the
Latest @ PyPI : unavailable (<reason>)value; a failed GitHub request prints theLatest @ GitHub : unknown (<reason>)value. -
Notifications are written to stderr;
--verand--versionexit with0.
Upgrade and Uninstall
The tool is installed with Astral uv (see Quick Start). Upgrade through the CLI (latest version published on PyPI):
cli-skills --upgrade
Upgrade from the newest tagged GitHub release instead (intermediate and test releases) by combining --upgrade with --dev or --develop:
cli-skills --upgrade --dev
Force the download and the complete reinstallation instead of the standard install/update process by combining --upgrade with --force; the upgrade command appends the uv reinstallation options --force --reinstall --refresh:
cli-skills --upgrade --force
Combine --dev or --develop with --force to force the reinstallation of the latest tagged GitHub release:
cli-skills --upgrade --dev --force
On Linux, a successful --upgrade runs cli-skills install automatically when at least one CLI is enabled, so the freshly upgraded package synchronizes the bundled skills into every enabled CLI. Its per-CLI report is part of the upgrade output and its exit code becomes the command exit code; no install runs when no CLI is enabled.
--dev, --develop, and --force are valid only after --upgrade; using them alone or before --upgrade, or combining --dev with --develop, prints an unknown-command diagnostic and exits with 2.
Uninstall through the CLI:
cli-skills --uninstall
Manual uninstall:
uv tool uninstall cli-skills
Install from GitHub
Intermediate and test releases are published on GitHub: https://github.com/Ogekuri/CLI-Skills.
Install the latest tagged GitHub release directly:
uv tool install cli-skills --from git+https://github.com/Ogekuri/CLI-Skills.git
Afterwards, upgrade to the newest GitHub release with the dedicated upgrade option:
cli-skills --upgrade --dev
--dev (long form --develop) is an --upgrade option: it always installs the newest tagged release on GitHub, regardless of the branch it was tagged on. Combine it with --force to force the download and the complete reinstallation of that release.
Live execution with uvx
Run cli-skills on the fly from PyPI without installing the tool:
uvx cli-skills --help
Use the same form for installation commands, for example:
uvx cli-skills install
Local Execution
Run the CLI from the repository checkout:
./scripts/cli-skills.sh --help
./scripts/cli-skills.sh enable pi
./scripts/cli-skills.sh install
The launcher delegates execution to Astral uv from the repository root.
Development
Run the tests:
uv run python -m unittest discover -s tests
Build the sdist and wheel into dist/:
./scripts/build.sh
./scripts/build.sh --output-dir /absolute/release/dir
./scripts/build.sh --clean --output-dir /absolute/release/dir
--output-dir requires an absolute path and defaults to dist/. --clean empties the release output directory while preserving the directory itself, removes build intermediates, and exits with 0 without building. A build prints the published file names and SHA-256 digests and exits nonzero when a mandatory build phase fails.
Run the full pre-release validation before a release:
./scripts/pre-release-check.sh
Acknowledgments
Uses Astral uv for packaging and execution and the Agent Skills directory format for bundled resources.
Metadata
Release files for cli-skills 0.10.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cli_skills-0.10.9.tar.gz | 91.5 kB | With provenance | Details for cli_skills-0.10.9.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cli_skills-0.10.9-py3-none-any.whl | Python 3 | none | any | Details for cli_skills-0.10.9-py3-none-any.whl |
Total release size: 188.7 kB
Release files / cli_skills-0.10.9.tar.gz
| Download URL | cli_skills-0.10.9.tar.gz |
|---|---|
| Size | 91.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c0f81f09d47bac04b7986725273e0954fe312f687838854fa62867df81f5d88
|
|
BLAKE2b-256 checksum How to use checksums |
f69a5ba888257acdeabcad5c26d937f16bb7b3d5080f2d160587c516a0fe3d0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / cli_skills-0.10.9-py3-none-any.whl
| Download URL | cli_skills-0.10.9-py3-none-any.whl |
|---|---|
| Size | 97.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b7b3a0b4d9783c1b0d670d4866cc6e7df0308e181b4d6e7ba717dbf4c7d9fb7
|
|
BLAKE2b-256 checksum How to use checksums |
4a35fb6dd6035b39c5d4261ce59479ed7fb150051fe7c5b389a8c30580eb2eeb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logSecurity for cli-skills 0.10.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for cli_skills-0.10.9.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.