skeel 0.1.0

Declarative agent skill manager with pluggable backends.

🛠️ 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:

uvx skeel --help

⚙️ Manifest

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

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

✨ Usage

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:

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