# AgentPlugins

A portable [Agent Plugins](https://agent-plugins.org) v1 plugin for converting components between coding-agent vendors: hooks, commands, tools, and rules.

This repo is the working home for cross-vendor conversion work — taking a capability built for one agent (e.g. a Claude Code hook or command) and making it usable in another (e.g. Antigravity, which has no commands).

## Contents

- `plugin.json` — portable v1 manifest (closed schema).
- `skills/migrate-agent-plugin/` — the migration skill (with references):
  - `references/migration-guide.md` — artifact mapping and step-by-step conversion.
  - `references/client-extensions.md` — when to use a client extension vs a compatibility layer.
  - `references/vendor-adoption.md` — which agents support Agent Plugins and which use their own formats.
  - `references/validation-checklist.md` — validation before finishing a migration.

## Layout

```text
AgentPlugins/
├── plugin.json
└── skills/
    └── migrate-agent-plugin/
        ├── SKILL.md
        └── references/
```

## Use it

Any conforming Agent Plugins client discovers `plugin.json` and the skills under `skills/`. Run the migration skill on a plugin folder to convert it to the portable v1 core while preserving client-specific behavior.

## Development

- Validate `plugin.json` against the canonical schema:
  ```sh
  npx ajv-cli validate --spec=draft2020 \
    -s ../../agent-plugins-spec/schemas/1.0.0/plugin.schema.json \
    -d plugin.json
  ```
- Keep skills at `skills/<name>/SKILL.md` with frontmatter `name` matching the directory.
- Version-bump `plugin.json` alongside any skill changes.

## License

MIT