Claude Code Agents & Skills

A curated collection of specialized Claude Code subagents and skills. Subagents are personas with focused expertise; skills are workflows you (or Claude) can invoke with /skill-name.

Quick start

# Clone
git clone https://github.com/jamestexas/agents.git
cd agents

# Preview what install would do
scripts/install.sh

# Symlink agents + skills into ~/.claude/{agents,skills}
scripts/install.sh --apply

install.sh is idempotent. Re-run any time you pull. Use --doctor to find broken symlinks left over from path moves.

Agents

Generated by scripts/build.sh readme. Edit the source file's frontmatter, not the table below.

Agent	Model	Color	Purpose
adversarial-synthesis-lead	opus	red	Use this agent to integrate findings from the six adversarial reviewers (dos-resilience-auditor, enumeration-oracle-hunter, bundle-isolation-tester, protocol-replay-adversary, trust-root-adversary, observability-gap-auditor), reconcile overlaps, prioritize, and promote findings into the threat-model + ADR record.
bundle-isolation-tester	opus	red	Use this agent for adversarial analysis of cross-tenant isolation in workerd-style hypervisors — slice-grant escapes, manifest misconfig exploitation, service-binding leakage, identity-confusion at the syscall boundary.
documentation-synthesis-architect	inherit	blue	Use this agent when you have sprawling, overlapping, or fragmented documentation that needs consolidation, restructuring, and distillation into coherent, non-redundant artifacts.
dos-resilience-auditor	opus	red	Use this agent for adversarial analysis of resource-exhaustion attack vectors in agent-hosting substrates — self-DoS via legal exits, single-threaded handler saturation, queue-depth attacks, fairness violations.
empirical-validation-designer	inherit	—	Translates theoretical claims into concrete, executable experiments that produce real results on real hardware
enumeration-oracle-hunter	opus	red	Use this agent to find side-channel and response-shape oracles that let an attacker enumerate names, existence, or relationships in a multi-tenant substrate.
experimental-design-architect	inherit	magenta	Specializes in translating high-level research philosophy into concrete, falsifiable, and scalable experimental protocols
mache-explorer	inherit	orange	Mount and explore structured data via mache FUSE filesystems.
observability-gap-auditor	opus	red	Use this agent for adversarial analysis of observability and alerting gaps — silent denial paths, alert deadlock under load, 'silence is evidence' invariants that break when the silence is from the substrate not the absence of activity.
paradigm-assessor	opus	red	Use this agent for a high-skepticism, 'red-team' audit of a novel 'paradigm-defining' framework.
platform-archaeologist	inherit	orange	Build complete infrastructure memory by traversing repositories and mapping all dependencies, migrations, and patterns.
platform-code-reviewer	inherit	green	Use this agent for reviewing Go, Terraform, and GCP infrastructure code with a focus on semantic correctness, not just syntax.
production-readiness-reviewer	inherit	blue	Use this agent when you need a comprehensive production readiness assessment of code before deployment.
protocol-replay-adversary	opus	red	Use this agent for adversarial analysis of protocol-state attacks — lease replay across windows, nonce-ledger gaps, epoch confusion, clock-skew exploitation, partial-failure replay across cross-DO orchestrators, receipt-chain forks.
repo-seo-curator	inherit	yellow	Use this agent to improve repository discoverability for the three audiences that find code: humans skimming GitHub/HN/search results, AI agents and LLMs ingesting context, and search engine crawlers.
research-paper-reviewer	inherit	green	Use this agent when you need expert-level review and analysis of academic papers, research proposals, or technical documents.
research-paper-writer	inherit	blue	Use this agent when you need to write academic papers, research reports, or technical manuscripts based on experimental results.
review-pattern-surfacer	inherit	magenta	Use this agent to analyze code review patterns from any GitHub user across specified repositories.
security-auditor	opus	red	Use this agent when you need adversarial security analysis of infrastructure, authentication flows, supply chain integrity, key management, or deployment configurations.
surgical-reviewer	inherit	cyan	Use this agent when you need precise, no-nonsense code review that focuses exclusively on necessary improvements.
theoretical-foundations-analyst	opus	purple	Use this agent when you need rigorous theoretical analysis of complex mathematical or computational systems, cross-disciplinary problem solving, or fundamental correctness review of novel approaches.
trust-root-adversary	opus	red	Use this agent for adversarial analysis of supply-chain and trust-root compromise scenarios — helper binary tamper, keystore confusion, CA bundle poisoning, kid (key-id) confusion, signer rotation races.

Skills

Generated by scripts/build.sh readme. Edit the source file's frontmatter, not the table below.

Skill	Tool scope	Purpose
break-glass	inherits all	Emergency IAM elevation for oncall/debugging.
diagram-gen-emergent	scoped	Generate a bottom-up community diagram from real code cross-references.
diagram-gen-spec	scoped	Generate a top-down structural diagram from a mache schema file.
doc-triage	inherits all	Find internal docs (not for external consumers), review against code reality, bead real items, archive stale files.
feature-impl	inherits all	Research-first feature implementation workflow.
mache-explore	inherits all	Mount a mache FUSE filesystem inside the project directory so agents can explore structured data without per-file permission prompts.
mache-usage	scoped	Start or locate a running mache MCP server for a source path or .db file.
pr-respond	scoped	Fresh-eyes review and review comment response for PRs.
pr-review	scoped	Give or respond to PR reviews with structural awareness via mache.
prior-art-cartographer	scoped	Produce structured comparisons between a project being built (described by a baseline doc) and external systems that solve adjacent problems.
problem-decomposer	scoped	Decompose an aspiration into a lattice of dispatchable bead specs using 5-whys descent + a 7-property dispatchability rubric.
readme-restructure	scoped	Restructure a README for both human skimmers and LLM ingestion.
repo-description-polish	scoped	Audit and polish the GitHub repository description — the one-sentence pitch shown in search results, link previews, and embeds.
repo-homepage-set	scoped	Audit and set the GitHub repository homepage URL — the link on the repo card's "About" panel and on every search result.
repo-social-preview	scoped	Audit the GitHub OpenGraph social preview image — the card shown when a repo URL is posted on HN, Twitter, Slack, or Discord.
repo-topic-tagger	scoped	Audit and apply GitHub topic tags (repository topics) on a target repo for discoverability — proposes tags from code signals, deduplicates against current tags, and applies via gh api after explicit user approval.
review-prep	scoped	Given a PR number or diff, synthesize spec-driven diagram, emergent diagram, and impact analysis into a structured insight: block for the reviewer.
self-audit	scoped	Pre-review self-audit of a PR branch.
survey	inherits all	Multi-perspective codebase survey that produces beads and mermaid diagrams from code structure.
work-scope	scoped	Decompose feature work into reviewable, shippable units before coding starts.

How agents and skills differ

	Agent	Skill
Invocation	Claude delegates automatically based on description; you can also invoke with the Agent tool	/skill-name (you) or automatic (Claude reads description)
Context	Runs in a separate context window	Inlined into the current conversation (or forked via context: fork)
Scope	A persona with long-lived methodology	A workflow with arguments and (optional) scoped tool permissions
Frontmatter required	name, description	description (name defaults to directory)

For full semantics, see Anthropic's subagents and skills docs.

Creating new agents/skills

The frontmatter is validated against both the Anthropic Claude Code spec and the stricter Gemini CLI spec — unknown fields fail lint because Gemini rejects them.

Agent (agents/<name>.md):

---
name: my-agent
description: "When to use, with embedded <example> blocks Claude reads."
model: inherit          # or sonnet / opus / haiku / claude-<full-id>
color: blue             # red blue green yellow purple orange pink cyan magenta
---

System prompt for the persona…

Skill (skills/<name>/SKILL.md):

---
name: my-skill
description: Trigger phrases and what this does.
allowed-tools: Bash Read Grep
argument-hint: <required> [optional]
---

Workflow body. `$ARGUMENTS` is substituted at invocation.

Run scripts/build.sh before committing — it lints frontmatter and regenerates the tables above.

Development

scripts/build.sh lint        # validate frontmatter only
scripts/build.sh readme      # regenerate README tables only
scripts/build.sh             # both (default)

scripts/install.sh           # dry-run: show planned symlinks
scripts/install.sh --apply   # create/update symlinks in ~/.claude/
scripts/install.sh --doctor  # remove broken symlinks (with --apply)

A pre-commit hook is configured in .pre-commit-config.yaml:

brew install pre-commit   # or: pip install pre-commit
pre-commit install

License

MIT — see LICENSE.