cli-skills (0.10.1)
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.
- Replace managed skill directories on every install and remove files that are no longer packaged.
- 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. - Check PyPI releases automatically with a 2-second timeout and a cached idle delay;
--veralso reports the latest GitHub release. - Run from a repository checkout, as a uv tool, or with uvx.
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.
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 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, show, --upgrade, --uninstall, --ver, or --version. |
cli-skills --ver |
Print the installed version plus the latest PyPI and GitHub versions; force a release check. |
cli-skills --version |
Print the installed version plus the latest PyPI and GitHub versions; force a release check. |
cli-skills --upgrade |
Upgrade from PyPI with uv on Linux; print the manual command on other platforms. |
cli-skills --upgrade --dev |
Upgrade to the latest GitHub release instead of PyPI (Linux); print the manual command elsewhere. |
cli-skills --upgrade --force |
Force download and complete reinstallation (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 show |
Show packaged resources, CLI configuration, and installation status. |
Exit codes:
0- success, includinginstallwith no enabled CLI.1- installation failed for at least one enabled CLI.2- unknown command or option, unsupported CLI name, or missing CLI name.
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 the installed skill count 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.
Configuration
The CLI stores its user configuration at:
~/.config/cli-skills/config.json
Example:
{
"enabled": [
"pi",
"claude"
]
}
enable and disable maintain the enabled array; edit only enabled when changing the configuration manually. A missing or invalid file is treated as an empty configuration.
Release Checks
- A release check runs before command dispatch.
- 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. - The check is skipped while the cached idle time is valid.
--verand--versionforce a check and print the installed version plus thePyPI latest:andGitHub latest:lines.- A newer release prints a bright-green message and sets a 3600-second idle delay.
- A failed check or no newer release prints a bright-red message and sets an 86400-second idle delay.
- Notifications are written to stderr.
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
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 --force --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 distributions:
uv run --frozen --with build python -m build
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.1
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.1.tar.gz | 85.6 kB | With provenance | Details for cli_skills-0.10.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cli_skills-0.10.1-py3-none-any.whl | Python 3 | none | any | Details for cli_skills-0.10.1-py3-none-any.whl |
Total release size: 161.9 kB
Release files / cli_skills-0.10.1.tar.gz
| Download URL | cli_skills-0.10.1.tar.gz |
|---|---|
| Size | 85.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b7773c8fa9de05fa37bc9aba51b26255ca2c1332b58e19e9936527f7a1d046a9
|
|
BLAKE2b-256 checksum How to use checksums |
a7cf992ef35fd8d80bb7148488730ecadddd5eebecc27842371895cefe41a062
|
| 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 9, 2026.
Transparency logRelease files / cli_skills-0.10.1-py3-none-any.whl
| Download URL | cli_skills-0.10.1-py3-none-any.whl |
|---|---|
| Size | 76.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b21a92317eecb86e106c410fe917bf7f6ddbc3b20e655c3fa83d4732e680de2c
|
|
BLAKE2b-256 checksum How to use checksums |
d4cdbb059dffdc00a4afb46dbb2b9d0040137b3130128047e1a74972eb134395
|
| 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 9, 2026.
Transparency logSecurity for cli-skills 0.10.1
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.1.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 9, 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.