Claude Code agents

This repository includes Claude Code subagents that run quality assurance checks against the repository. Unlike skills (which are user-invoked slash commands), agents are auto-invoked by Claude based on their description: frontmatter when the current task matches their role.

Downstream repositories can install them with:

$ uvx -- repomatic init subagents

To install a single subagent:

$ uvx -- repomatic init subagents/grunt-qa

Selectors use the same component[/file] syntax as the exclude config option in [tool.repomatic].

Note

The component is subagents, not agents, because agent is the neighbouring component writing the instructions file this page’s siblings describe. The two used to differ by one character while doing entirely different things.

These same subagents are also published as a Claude Code plugin, which installs them without committing any copy to your repository: see § Claude Code plugin.

To deploy them to a non-default directory (like a dotfiles repository where .claude/ is not at the root), set subagents.location in [tool.repomatic]:

[tool.repomatic]
include = ["subagents"]
subagents.location = "./dotfiles/.claude/agents/"

Available agents

Agent	Role
grunt-qa	Hands-on worker that fixes typos, ordering, style, doc-sync issues, and other mechanical CLAUDE.md violations.
qa-engineer	Senior engineer that handles deep code analysis, bug-class sweeps, and design decisions.
sphinx-docs	Documentation steward that keeps docs/ in sync with code and enforces MyST and click-extra conventions.

Self-containment

Like skills, agents must be self-contained for downstream portability. They reference claude.md sections rather than upstream docs/ URLs, so a downstream repo’s Claude can resolve every reference locally without network access.