Structural standards for agent skill files — invoke when adding, editing, or reviewing a skill's structure. Covers the published-guidance baseline, composition, frontmatter, the ref- naming rule, degrees of freedom, body shape, multi-file layout, and lifecycle; pair with ref-skill-effectiveness for content quality.
Content-quality standards for agent-facing prose — invoke when authoring or reviewing anything an AI agent reads at decision or execution time: skill descriptions and bodies, AGENTS.md rules, MCP tool docstrings, error-code help text. Covers triggerability, actionability, outcome orientation, examples, clarity…
Perform a deep review of a changeset — invoke when reviewing a set of code changes spanning more than one file, before committing; use review-python-file for a single file in depth. Routes each file to its type-specific review skill, then adds the cross-cutting checks (unrequested surface, design consistency, DRY…
Perform a comprehensive review of a single Python file — invoke when reviewing one file in depth; use review-changes for a multi-file changeset. Covers design, correctness, DRY, security, type safety, pydocs, imports, logging, and test coverage.
Run precommit.sh before committing — invoke after any code or documentation edit, and before staging. It modifies files in place, so re-check the diff afterward. Applies isort, black, ruff, mypy, codespell, and markdownlint in sequence, stopping at the first failure.
Add a new agent skill end-to-end — invoke when creating a new file under .agents/skills/. Runs the composition gate, chooses the name and ref- prefix, drafts a triggering description and a body that satisfies the effectiveness and structural standards, cross-links parents, registers the catalog README row, and runs…
Review an existing agent skill (.agents/skills//SKILL.md) or the project AGENTS.md — invoke when editing or auditing a skill or AGENTS.md; also dispatched by review-changes on changes to those paths. Runs the composition, effectiveness, structural, and cross-reference audits plus README sync and AGENTS.md overlap…
Comprehensively improve unit tests — invoke when a source file's coverage is below the 100%-per-file target, or its test file is missing or disorganized. Ensures test files exist, adds missing tests, removes unneeded ones, and restructures to reach full per-source-file coverage.
Run the full unit test suite with coverage — invoke to verify a change across the whole project; use tests-run-file when assessing one source file's per-file coverage. Reports test failures and uncovered lines.