# Agent Toolkit Guide

A collection of reusable skills and rules for AI agents (Claude Code and similar). Everything must
be self-contained and generic — reusable in any project — so avoid project-specific logic or
assumptions. Rules are opt-in: a skill must work correctly with no rules installed, so never fix
or extend a skill by adding a rule it depends on.

Skill test harnesses live in `test/<skill-name>/` — repo-internal, never installed; their `runs/`
output dirs are gitignored. Planning documents go in `.agents/plans/` (gitignored).

## Docs

- [docs/authoring-conventions.md](docs/authoring-conventions.md) — read before editing any skill,
  rule, doc or manifest.
- [docs/core-philosophy.md](docs/core-philosophy.md) — the five pillars and their litmus test;
  read before creating or redesigning a skill, or when brainstorming toolkit direction.
- [docs/contributor-setup.md](docs/contributor-setup.md) — how this repo is wired for agents; read
  when hooking a new agent up to it.