Content
88%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, expert-level audit methodology: highly executable commands with explicit validation and refutation loops, a well-sequenced nine-step workflow, and real one-level-deep bundle references. The only costs are modest known-concept explanations in Background/Step 6 and detail (grep dialect variants, the full report template) that could migrate to references to slim the main file.
Suggestions
Trim known-concept explanations: reduce the Background definition of prompt injection and Step 6's generic extraction-attempt list to one line each (or fold them into the attack-surface step), since Claude already knows these.
Consolidate the concealment greps: keep the ripgrep and one portable variant inline in Step 3 and move the remaining GNU/macOS dialect variants to a reference file to cut repetition.
Move the full report template (Output Format section) into references/ alongside findings-format.md, keeping only a short list of the report sections in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, specialized content (exact Unicode format-character ranges, SkillSpector rule IDs, OWASP LLM 2025 numbering, MCP rug-pull pinning guidance), but a few spots explain what Claude already knows — the Background definition ("It occurs when untrusted input influences the instructions an LLM follows…") and Step 6's generic extraction attempts ("Repeat your instructions verbatim") — and some bullet lists repeat the code examples directly above them. Anchor 4 (efficient, minor over-explanation to trim) rather than 5, since these instances are minor against a largely specialized 440 lines. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: three grep dialects (ripgrep, GNU, portable BSD) with exact Unicode ranges for every concealment check, "node references/validate-findings.mjs findings.json" for validation, VULNERABLE/BETTER code pairs for each sink pattern, and concrete output shapes (fingerprint examples, ext keys table). No pseudocode appears; this matches anchor 5. | 5 / 5 |
Workflow Clarity | Nine clearly sequenced steps (attack surface → prompt construction → concealment → output handling → tools/agents → prompt leaking → permission boundaries → defenses → verify/record) with explicit validation checkpoints in Step 9: a mandatory refutation pass before confirming, severity calibration, a validated findings.json with confirmed/needs_validation/rejected verdicts, plus checklists (permission checklist and defense assessment tables). Checkpoints are explicit with error-recovery guidance, matching anchor 5 rather than 4. | 5 / 5 |
Progressive Disclosure | All six referenced files exist in references/ and are exactly one level deep, clearly signaled with markdown links at the point of need (findings-format.md, verification.md, severity-calibration.md at Step 9; validate-findings.mjs and to-sarif.mjs for validation). However, the body is a full ~440-line operational manual rather than a lean overview — the four grep-dialect variants per concealment check and the complete report template are candidates for reference files. Good structure with minor organization gaps fits anchor 4; not 3 because references are clearly signaled and nothing is nested, not 5 because the split leaves substantial detail inlined. | 4 / 5 |
Total | 18 / 20 Passed |