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

OpenCode Setup

OpenCode natively loads Agent Skills and reads AGENTS.md, 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 -- opencode

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

Manual equivalent:

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

OpenCode also discovers Claude-compatible ~/.claude/skills/*/SKILL.md, so an existing Claude install (if flat) is picked up automatically.

Invoke

Just ask — OpenCode auto-selects skills from each description:

• "review this PR" → brooks-review
• "audit the architecture" → brooks-audit
• "where's our worst tech debt?" → brooks-debt

For explicit invocation, /brooks-review etc. are available once the skill is discovered. The repo's AGENTS.md carries the Iron Law (Symptom → Source → Consequence → Remedy) and the Health Score rules.

Notes

• Flat layout is mandatory (the installer guarantees it): skills read ../_shared/, which only resolves when _shared/ sits beside the brooks-* folders.
• 🧪 Documented per the official skills and rules docs; community end-to-end verification welcome — open an issue.