README

README is an agent for Claude Code from nexus-substrate/nexus-agents. It costs 0 tokens per session (710 once invoked), scanned A, original, MIT.

A set of review-persona instructions for delegating code reviews to helper agents. Each persona gives a human-readable review focused on a particular perspective, separate from the project's structured voting experts.

In plain words
What is it for?
Use it to dispatch ad-hoc reviews such as a senior code review through an agent tool. The documented review areas include correctness, readability, architecture, security, and performance.
Why use it?
It clarifies which kind of reviewer to use and keeps narrative reviews separate from automated consensus results. This prevents the two review systems from being mixed together.

Agent for Claude Code

Part of the nexus-agents plugin — 33 skills, 16 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/nexus-substrate/nexus-agents/readme
Clone the repo
git clone --depth 1 https://github.com/nexus-substrate/nexus-agents

Made for: Claude Code.

Or install nexus-agents, the plugin that ships this one along with the rest of its 33 skills, 16 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for README

README.md
[![agentmods](https://agentmods.dev/badge/agents/nexus-substrate/nexus-agents/readme.svg)](https://agentmods.dev/agents/nexus-substrate/nexus-agents/readme)
Your own site
<a href="https://agentmods.dev/agents/nexus-substrate/nexus-agents/readme"><img src="https://agentmods.dev/badge/agents/nexus-substrate/nexus-agents/readme.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 710 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00710
Opus 5 $0.00000 $0.00355
Sonnet 5 $0.00000 $0.00142
Haiku 4.5 $0.00000 $0.00071

Measured 4d ago against content hash 60ade45b3b4e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

README scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/README.md · 53 lines

How it starts

The opening of the file, as written. The whole thing — 53 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Subagent persona prompts

Human-facing review personas for the Agent tool's subagent_type parameter (Claude Code) or any equivalent subagent invocation surface. These are not the same as the voter-pipeline experts in agents/ at the repo root.

When to use these vs the voter-pipeline experts

Surface Lives in Output shape Consumed by
Voter-pipeline experts agents/*.md (repo root) Structured JSON with confidence, severity, issues[], suggestions[], etc. ConsensusEngine, voterPanel, consensus_vote MCP tool
Persona prompts (this dir) .claude/agents/*.md Human-readable narrative review with categorized findings Direct human review, ad-hoc subagent dispatch via the Agent tool

The two surfaces coexist. Architect QA on epic #2385 explicitly authorized this split: "adopt only as subagent prompt templates, not as new voter roles, to avoid panel inflation." Don't merge them.

Personas

File Purpose Voter-pipeline counterpart
code-reviewer.md Senior code-review persona (Staff Engineer voice). Five-axis assessment: correctness, readability, architecture, security, performance. Findings categorized Critical / Important / Suggestion. agents/code-expert.md
security-auditor.md Security audit persona. Vulnerability scan, threat modeling, OWASP-aligned findings, severity classification. agents/security-expert.md
test-engineer.md Test-engineer persona. Coverage assessment, missing edge cases, test-quality review (DAMP, AAA, naming). agents/testing-expert.md

Read the full file on GitHub · 53 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 53 lines · 0 tokens per session scan A 60ade45b3b4e

Subscribe to this mod's changes

README is an agent published in the GitHub repository nexus-substrate/nexus-agents (18 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 710 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.