Metadata-Version: 2.4
Name: agent-skill-installer
Version: 0.5.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,gemini,antigravity
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: json-five==1.1.2
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, 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](docs/installing-skills.md). Skill
metadata and per-agent hook schemas are in [Authoring Skills](docs/authoring-skills.md).

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