agent-skill-installer 0.3.0

Generic installer core for projects that distribute agent skills

Agent Skill Installer

	Description
Project
Status
Docs and support

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

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.