Guide review
Skill adobe/ai-repo-harness-guide/.agents/skills/guide-review
Review a multi-chapter guide, series, or book from six specialist perspectives. Orchestrates Series Editor, Non-Technical Proxy, Practitioner Proxy, Consistency Auditor, Diagram Reviewer, and Claims Auditor. Use for single-chapter review, full-series audit, consistency checks, diagram audits, and claims audits.From its SKILL.md
npx -y skills add adobe/ai-repo-harness-guide --skill guide-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.4 KB, as published. Nobody here has run it
Guide Review — Multi-Perspective Review Panel
Configure for your work
Before running any workflow, read the work's README or table of contents to establish:
- All chapters, their titles, and reading order
- Which chapters target non-technical readers vs. practitioners
- Diagram format in use (Mermaid, PlantUML, images, etc.)
- Any stated style rules, invariants, or editorial constraints
Agent roster
| Agent | Persona | Activate for |
|---|---|---|
| Series Editor | Narrative Architect | Arc, voice, flow, and bloat across all chapters |
| Non-Technical Proxy | Skeptical decision-maker | Non-technical chapters — accessibility, business clarity, engagement |
| Practitioner Proxy | Impatient senior engineer | Technical chapters — actionability, depth, implementability |
| Consistency Auditor | Cross-chapter editor | Terminology drift, duplication, model consistency, link integrity |
| Diagram Reviewer | Visual clarity judge | Diagram quality, placement, accuracy, and format compliance |
| Claims Auditor | Skeptical copy editor | Unsupported claims, overstatements, weasel words, false precision |
Workflows
Single-chapter review (quick)
- Identify whether the chapter targets a non-technical or practitioner audience.
- Relevant Proxy reviews for engagement and actionability.
- Series Editor checks voice consistency and transition into the next chapter.
- Claims Auditor flags any unsupported assertions.
- Surface findings to author.
Full series audit (thorough)
- Series Editor reads all chapters for arc, flow, and bloat.
- Non-Technical Proxy reviews non-technical chapters.
- Practitioner Proxy reviews practitioner chapters.
- Consistency Auditor runs a cross-chapter pass.
- Diagram Reviewer audits all visuals.
- Claims Auditor audits all chapters.
- Series Editor synthesizes findings into a prioritized revision list.
- Surface to author for approval.
Consistency check (targeted)
- Consistency Auditor scans for terminology drift, duplication, and broken links.
- Series Editor reviews findings for impact on arc and voice.
- Surface to author.
Diagram audit (targeted)
- Diagram Reviewer scans all chapters for visual opportunities and format issues.
- Series Editor reviews visual density and cross-chapter consistency.
- Surface to author.
Claims audit (targeted)
- Claims Auditor reads all chapters and produces structured report.
- Surface flagged claims to author for resolution.
Quality gates
Every chapter must pass before the author approves:
- Series Editor: voice consistent, no bloat, transition to next chapter present
- Relevant Proxy: engagement and actionability confirmed
- Claims Auditor: all claims verified, qualified, or flagged for removal
- Diagram Reviewer: visuals present where needed, accurate, format-compliant
- Author approval