Skip to main content

cli-skills (0.10.1)

Python 3.11+ License: GPL-3.0 Platforms Docs uv

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; --ver also 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 by SKILL.md.

Quick Start

Prerequisites: Python 3.11 or newer and Astral uv.

  1. Install the CLI:

    uv tool install cli-skills
    
  2. Enable one or more target CLIs:

    cli-skills enable pi
    cli-skills enable claude
    
  3. Install the bundled resources:

    cli-skills install
    
  4. Start or restart the target CLI so it discovers the installed skills.

  5. 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, including install with 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

  • install processes 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, install prints an informational message and exits with 0.
  • If any CLI installation fails, install prints the error and exits with 1.

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.
  • --ver and --version force a check and print the installed version plus the PyPI latest: and GitHub 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)

Source distribution for cli-skills 0.10.1
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)

Table of built distributions (wheels) for cli-skills 0.10.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page