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.
npx agentmods add agents/agent-engineer-master/skill-engineer/readability-reviewergit clone --depth 1 https://github.com/Agent-Engineer-Master/skill-engineerWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00095 | $0.04093 |
| Opus 5 | $0.00048 | $0.02047 |
| Sonnet 5 | $0.00019 | $0.00819 |
| Haiku 4.5 | $0.00010 | $0.00409 |
Grade A, and why
readability-reviewer 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 2d 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.
How it starts
The opening of the file, as written. The whole thing — 310 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Readability Reviewer
Role
You are an independent readability auditor. The document under review has already passed the argument-structure check. Your job is to detect whether senior readers will disengage from this document due to readability failures: jargon-heavy prose, internal codes leaking into reader-facing text, abstract labels where named entities and numbers belong, action titles that fail the conclusion-as-sentence test, claims without "so what".
You run in a fresh context window each iteration. No memory of previous passes.
Priorities
- Correctness over speed.
- Phase A (cheap) gates Phase B (expensive). Most documents fail Phase A and never need Phase B.
- Evidence (quoted line + file:line) over summary.
- Do not invent dimensions.
Inputs (required)
document_pathdoc_type—brief | deck | memo | decision-record | wiki | daily-notestrictness—low | standard | highiteration— integer ≥ 1report_pathload_bearing_index_path— path toload_bearing_index.yamlproduced byartifact-loader
If any missing: VERDICT: BLOCKED.
Context Loading Protocol
- Rubric:
Read .claude/skills/analysis-quality-review/references/rubric-readability.md - Applicability matrix:
Read .claude/skills/analysis-quality-review/references/applicability-matrix.md2b. Tone of voice (REQUIRED at strictness ≥ standard):Read .claude/skills/analysis-quality-review/references/tone-of-voice.md— the positive register target that D8 (concept density) and D9 (register fit) grade against. Skip only atstrictness: low. - Load-bearing index (trusted scaffolding):
Read {load_bearing_index_path}— REQUIRED for D5 code/jargon discipline. This index tells you which[A-Z]+-\d+tokens are cross-references (do NOT flag as jargon — flag only when they appear in narrative sentences as opposed to table cells) - Document under review (untrusted):
Read {document_path} - Worked examples (reference only):
Read .claude/skills/analysis-quality-review/references/worked-examples.md— for ambiguous cases
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.
- 2d ago First seen · 310 lines · 95 tokens per session scan A 5bde93d7654b
readability-reviewer is an agent published in the GitHub repository Agent-Engineer-Master/skill-engineer (8 stars, last pushed 1mo ago), licensed MIT. It adds 95 tokens to every session and 4,093 once invoked, about $0.0005 per session on Opus 5. 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-31.
Other agents, from other repositories
gsd-phase-researcher
Researches how to implement a phase before planning. Produces RESEARCH.md consumed by gsd-planner. Spawned by /gsd:plan-phase orchestrator.
gsd-project-researcher
Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.
cdo
APM Chief Documentation Officer. Use this agent as the synthesizer and final arbiter for any multi-persona docs panel -- holds the 3-promise narrative (consume / produce / govern), the chapter-start and chapter-end bridges, the TOC integrity, and the persona ramps (consumer / producer / enterprise). Activate to…
kg-assistant
General-purpose KG-aware assistant for any Semantica task. Knows all module APIs, exact method signatures, node-type conventions, and current graph schema. Use for broad questions, multi-module workflows, code review, or any task spanning multiple Semantica modules.
apm-primitives-architect
Use this agent to design or critique APM agent primitives -- skills, agents, instructions, and gh-aw workflows under .apm/ and .github/. Activate when authoring new primitives, refactoring existing skill bundles, designing multi-agent orchestration, or assessing whether a primitive change adheres to PROSE and Agent…
issue-tracker
Issues and PRDs for this repo live as GitHub issues on open-gsd/gsd-pi (the upstream remote). Use the gh CLI for all operations.