Skip to main content

Agent Skill Installer

Description
Project PyPI versionDownloads Python License
Status CI Publish
Docs and support Zulip chat

agent-skill-installer installs agent skills for Codex, Claude Code, Gemini CLI, and Antigravity from local skill directories, GitHub repositories, or PyPI wheels. It supports directory and global targets, can assert directory targets are Git or Sapling repositories with --repo, writes discoverability blocks into the target's instruction files, and records enough install state to safely upgrade or uninstall skills it owns.

Agent targets

Gemini CLI and Antigravity integrations are experimental. Antigravity has had limited manual testing; Gemini CLI has not yet had manual testing. Verify the installed skills, discoverability, and hooks in the agent before relying on them.

Use one target, a comma-separated list, or --agent all:

Target Directory discovery Global discovery Runtime hooks
codex .codex/skills and AGENTS.md ~/.codex/skills and ~/.codex/AGENTS.md .codex/hooks.json
claude .claude/skills and CLAUDE.md ~/.claude/skills and ~/.claude/CLAUDE.md Not installed
gemini (experimental) .gemini/skills and GEMINI.md ~/.gemini/skills and ~/.gemini/GEMINI.md .gemini/settings.json
antigravity (experimental) .agents/skills and .agents/rules/*.md ~/.gemini/config/skills and ~/.gemini/config/rules/*.md .agents/hooks.json

The complete path matrix, target-home overrides, hook behavior, and uninstall ownership rules are in Installing Skills. Skill metadata and per-agent hook schemas are in Authoring Skills.

Install

python -m pip install agent-skill-installer

Run the interactive installer:

agent-skill-installer

Interactive install source picker

Use --no-ui for scripts:

agent-skill-installer --no-ui install \
  --skill-path ./my-skill \
  --editable \
  --agent codex \
  --scope dir \
  --repo

Documentation

Audience Start here
Installing a skill Installing Skills
Writing a skill directory or GitHub skill repo Authoring Skills
Publishing a skill on PyPI or with platform wheels Packaging
Embedding the installer API or exposing a wrapper CLI API And Wrapper CLI
Maintaining releases Maintainer Guide

Examples

The examples/ directory contains runnable integrations:

  • examples/demo-installer/ is a complete Python package that carries a bundled skill and exposes a project-specific wrapper command.
  • examples/wheel-skill/ is a plain wheel-packaged skill for generic --wheel-file installs.
  • examples/api-install/ shows direct Python API usage without a wrapper console script.

Metadata

Release files for agent-skill-installer 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-skill-installer 0.5.0
File Size Uploaded Provenance Actions
agent_skill_installer-0.5.0.tar.gz 126.2 kB With provenance Details for agent_skill_installer-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-skill-installer 0.5.0
File Interpreter ABI Platform Actions
agent_skill_installer-0.5.0-py3-none-any.whl Python 3 none any Details for agent_skill_installer-0.5.0-py3-none-any.whl

Total release size: 206.3 kB

Release files / agent_skill_installer-0.5.0.tar.gz

Download URL agent_skill_installer-0.5.0.tar.gz
Size 126.2 kB
Tags Source
SHA-256 checksum
How to use checksums
dca88cb34e20efb71f81f96cb8a8683b69b05de3d24fd90c8cfe6bf055b69091
BLAKE2b-256 checksum
How to use checksums
12ce99970104e1726ed9f34471267f0b2fab3347825f8f32166943c5a6029e33
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 22, 2026.

Transparency log

Release files / agent_skill_installer-0.5.0-py3-none-any.whl

Download URL agent_skill_installer-0.5.0-py3-none-any.whl
Size 80.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c3ef5d114ceb7d5f7e6df90eeb736ecea835119534efb48f08175795532b78d7
BLAKE2b-256 checksum
How to use checksums
27c3555e183cee92242da312f9bc06aa784ce26078203aab84d824e43ab90a62
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 22, 2026.

Transparency log

Security for agent-skill-installer 0.5.0

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 agent_skill_installer-0.5.0.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 22, 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.

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files Full provenance

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