Metadata-Version: 2.4
Name: docketeer-agentskills
Version: 0.0.12
Summary: Agent Skills plugin for Docketeer
Project-URL: Homepage, https://github.com/chrisguidry/docketeer
Project-URL: Repository, https://github.com/chrisguidry/docketeer
Project-URL: Issues, https://github.com/chrisguidry/docketeer/issues
Author-email: Chris Guidry <guid@omg.lol>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: docketeer
Requires-Dist: pyyaml
Description-Content-Type: text/markdown

# docketeer-agentskills

[Agent Skills](https://agentskills.io/specification) plugin for
[Docketeer](https://github.com/chrisguidry/docketeer).

Adds support for installing, managing, and using skills packaged as directories
with a `SKILL.md` file (YAML frontmatter + markdown instructions).

## Tools

| Tool | Description |
|------|-------------|
| `list_skills` | List installed skills with descriptions |
| `activate_skill` | Load a skill's full instructions |
| `read_skill_file` | Read any file from a skill directory |
| `install_skill` | Install a skill from a git repository |
| `uninstall_skill` | Remove an installed skill |

## How it works

Skills live in `{workspace}/skills/`. The plugin provides three levels of
progressive disclosure:

1. **System prompt** — skill names and descriptions are always available
2. **activate_skill** — loads the full SKILL.md body on demand
3. **read_skill_file** — reads any file from the skill directory on demand

## Configuration

No configuration required. Skills are discovered automatically from the
`skills/` directory in the agent's workspace.
