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 and Claude Code from local skill directories, GitHub repositories, or PyPI wheels. It supports directory and global install targets, can assert directory targets are Git or Sapling repositories with --repo, writes discoverability blocks into the agent hook files, and records enough install state to safely upgrade or uninstall skills it owns.

Additional agent targets or installer functionality are open for discussion, and pull requests are welcome.

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.4.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.4.0
File Size Uploaded
agent_skill_installer-0.4.0.tar.gz 108.0 kB Details

Built distribution (wheel)

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

Total release size: 170.8 kB

Release files / agent_skill_installer-0.4.0.tar.gz

Download URL agent_skill_installer-0.4.0.tar.gz
Size 108.0 kB
Tags Source
SHA-256 checksum
How to use checksums
98c3cc3cb3b38a02ac4f2637f0fd20ec3fc29ddc740b9120f3051e864e140b50
BLAKE2b-256 checksum
How to use checksums
f0a062387b4cca92532403c76f2f346e23589c789999521e88d6c9d7cff626fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 1, 2026.

Transparency log

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

Download URL agent_skill_installer-0.4.0-py3-none-any.whl
Size 62.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f52361aafde2669576b1fed787e0535579ec606a95121c579de6bf465738b7a2
BLAKE2b-256 checksum
How to use checksums
e9ec751c871b92dc6a69eedc96fea723d2e1a7778893859f4c18eb9bcf3b007a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Sep 1, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

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