playbook/brooks-lint/docs/kiro-setup.md

Kiro Setup

AWS Kiro (IDE & CLI) natively loads Claude-compatible Agent Skills, reads AGENTS.md, and auto-registers each skill as a slash command, so all six brooks-lint modes run with no conversion.

Install

# simplest — one command (global)
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- kiro

# from a clone
./scripts/install.sh kiro            # global:  ~/.kiro/skills
./scripts/install.sh kiro --project  # this repo: ./.kiro/skills

Manual equivalent:

git clone https://github.com/hyhmrright/brooks-lint.git /tmp/brooks-lint
mkdir -p ~/.kiro/skills
cp -r /tmp/brooks-lint/skills/* ~/.kiro/skills/   # flat — brooks-* and _shared/ as siblings

Or use the IDE: Agent Steering & Skills panel → + → Import a skill → paste a GitHub URL or pick a local folder (Kiro copies it into your skills folder).

Invoke

Ask naturally ("review this PR", "audit the architecture"), or use the auto-registered slash command /brooks-review. AGENTS.md is always-included and carries the Iron Law and Health Score rules.

Notes

• Flat layout is mandatory (the installer guarantees it): ../_shared/ only resolves when _shared/ is a sibling of the brooks-* folders.
• Kiro requires the folder name to equal the skill's name (✅ already true here), name ≤ 64 chars, and description ≤ 1024 chars (brooks-lint's longest is ~920).
• 🧪 Documented per the official skills docs; community end-to-end verification welcome — open an issue.