Metadata-Version: 2.4
Name: skeel
Version: 0.1.0
Summary: Declarative agent skill manager with pluggable backends.
Project-URL: Homepage, https://github.com/mavam/skeel
Project-URL: Repository, https://github.com/mavam/skeel
Project-URL: Bug Tracker, https://github.com/mavam/skeel/issues
Author: Matthias Vallentin
License-Expression: MIT
License-File: LICENSE
Keywords: agent-skills,agents,cli,github-cli,skills
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Version Control
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.14
Requires-Dist: pyyaml>=6.0.2
Description-Content-Type: text/markdown

# 🛠️ skeel

Declarative agent skill management.

**skeel** reads a desired-state manifest and applies it through a backend.

The first backend is `gh skill` from GitHub CLI.

## ✨ Features

- **Desired state**: declare skills, sources, shared install directory, and
  target agents in one YAML file
- **Plan and diff**: preview commands and compare managed skills against what's
  installed locally
- **Apply and update**: install missing skills and update gh-managed skills
- **Agent links**: installs once into a shared directory and links skills into
  agent-specific locations such as Claude Code

## 🚀 Quickstart

Run `skeel` directly with `uvx`:

```sh
uvx skeel --help
```

## ⚙️ Manifest

Default path: `~/.agents/.skill.yaml`

```yaml
version: 1
shared_dir: ~/.agents/skills
agents:
  - universal
  - claude-code
sources:
  - source: openclaw/gogcli
    allow_hidden_dirs: true
    skills:
      - gog
```

## ✨ Usage

```sh
uvx skeel plan    # print commands
uvx skeel diff    # compare desired vs installed skills
uvx skeel apply   # install desired state
uvx skeel update  # update installed gh-managed skills
uvx skeel path    # print manifest path
```

## 🧰 Backend policy

`skeel` installs each skill into the shared directory with:

```sh
gh skill install <repo> <skill> --dir ~/.agents/skills --force
```

For `claude-code`, it creates symlinks from `~/.claude/skills/<skill>` to the
shared skill directory.

## 📄 License

[MIT](LICENSE)
