Metadata-Version: 2.4
Name: agent-skill-installer
Version: 0.3.0
Summary: Generic installer core for projects that distribute agent skills
Author: Omry Yadan
License-Expression: MIT
Project-URL: Homepage, https://github.com/omry/agent-skill-installer
Project-URL: Repository, https://github.com/omry/agent-skill-installer
Project-URL: Issues, https://github.com/omry/agent-skill-installer/issues
Project-URL: Documentation, https://github.com/omry/agent-skill-installer#readme
Keywords: agents,skills,installer,codex,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: omegaconf>=2.3.0
Requires-Dist: packaging>=24.0
Requires-Dist: textual>=0.89.0
Dynamic: license-file

# Agent Skill Installer

|  | Description |
| --- | --- |
| Project | [![PyPI version](https://badge.fury.io/py/agent-skill-installer.svg)](https://badge.fury.io/py/agent-skill-installer)[![Downloads](https://pepy.tech/badge/agent-skill-installer/month)](https://pepy.tech/project/agent-skill-installer) [![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://pypi.org/project/agent-skill-installer/) [![License](https://img.shields.io/pypi/l/agent-skill-installer.svg)](https://github.com/omry/agent-skill-installer/blob/main/LICENSE) |
| Status | [![CI](https://github.com/omry/agent-skill-installer/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/omry/agent-skill-installer/actions/workflows/ci.yml) [![Publish](https://github.com/omry/agent-skill-installer/actions/workflows/publish.yml/badge.svg)](https://github.com/omry/agent-skill-installer/actions/workflows/publish.yml) |
| Docs and support | [![Zulip chat](https://img.shields.io/badge/chat-Zulip-2e77d0?logo=zulip)](https://hydra-framework.zulipchat.com/#narrow/channel/agent-skill-installer) |

`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

```bash
python -m pip install agent-skill-installer
```

Run the interactive installer:

```bash
agent-skill-installer
```

![Interactive install source picker](https://raw.githubusercontent.com/omry/agent-skill-installer/main/docs/images/ui-install.png)

Use `--no-ui` for scripts:

```bash
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](https://github.com/omry/agent-skill-installer/blob/main/docs/installing-skills.md) |
| Writing a skill directory or GitHub skill repo | [Authoring Skills](https://github.com/omry/agent-skill-installer/blob/main/docs/authoring-skills.md) |
| Publishing a skill on PyPI or with platform wheels | [Packaging](https://github.com/omry/agent-skill-installer/blob/main/docs/packaging.md) |
| Embedding the installer API or exposing a wrapper CLI | [API And Wrapper CLI](https://github.com/omry/agent-skill-installer/blob/main/docs/api-and-wrapper-cli.md) |
| Maintaining releases | [Maintainer Guide](https://github.com/omry/agent-skill-installer/blob/main/docs/maintainer-guide.md) |

## Examples

The [`examples/`](https://github.com/omry/agent-skill-installer/blob/main/examples/README.md) 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.
