# AGENTS.md

Subagent instructions for this repository. Keep prompts minimal.

## Context

Porting allium (Claude Code plugin) to pi.dev skills. Upstream lives in `allium-main/`. Port output goes in `.pi/skills/`. See `allium-port-plan.md` for full plan.

## Agent: skill-porter

Adapt a Claude Code skill to a pi.dev skill.

**Input:** upstream skill path (e.g. `allium-main/skills/elicit/SKILL.md`)
**Output:** `.pi/skills/{name}/SKILL.md` + symlinked `references/`

Steps:
1. Read upstream SKILL.md
2. Replace frontmatter: add `disable-model-invocation: true`, `license: MIT`, `metadata` block
3. Replace Claude invocation references (`/allium:X`) with pi references (`/skill:X`)
4. Preserve body content verbatim
5. Create `references/` symlink to upstream references dir (relative path)

## Agent: smoke-tester

Verify a ported skill loads and responds correctly.

**Input:** skill name
**Steps:**
1. Check `.pi/skills/{name}/SKILL.md` exists and has valid frontmatter
2. Check `references/` symlink resolves
3. Report ready for manual `pi -p` test with `/skill:{name}`