Content
77%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.
The execution workflow is exceptionally actionable with explicit phase ordering, checkpoints, and early-exit handling, and the subagent prompt templates are copy-paste ready. The weaknesses are token efficiency — duplicated hardening snippets and a generic XXE tutorial — and the absence of any progressive disclosure, with all per-language reference material inlined in one monolithic file.
Suggestions
Remove the 'Patterns That Prevent XXE' section (or fold it into the examples) — its 8 hardening snippets are duplicated by the SECURE halves of 'Vulnerable vs. Secure Examples' and again by Phase 1's 'What to skip' list.
Split the per-language vulnerable/secure examples into reference files (e.g., references/java.md, references/php.md) and have Phase 2 pass only the matching file, replacing the manual '[TECH-STACK EXAMPLES]' copy step.
Trim the 'What is XXE' concept introduction to only the skill-specific boundaries (the IS/NOT lists and the LIBXML_NOENT caveat), dropping the general tutorial Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The execution phases are efficient, but the 'What is XXE' tutorial restates knowledge Claude already has, and the 8 'Patterns That Prevent XXE' snippets are largely duplicated by the SECURE halves of 'Vulnerable vs. Secure Examples' (with safe patterns appearing a third time in Phase 1's 'What to skip'). Mostly efficient with some unnecessary explanation and tightening opportunities — anchor 3; not 2 because the majority of the body (phase instructions, flag/skip lists) earns its tokens. | 3 / 5 |
Actionability | Guidance is fully executable: grep-able per-language API lists ('etree.fromstring(...)', 'DocumentBuilderFactory.newInstance()'), copy-paste subagent prompt templates with exact output formats, and a ready curl XXE payload with Content-Type header. Matches anchor 5; not 4 because the common cases are covered end-to-end with no gaps. | 5 / 5 |
Workflow Clarity | The three phases are explicitly ordered ('Phase 2 must run AFTER Phase 1 — it depends on the recon output'), with an early-exit validation checkpoint on zero recon findings, a worked batching procedure ('8 sites → 3 batches'), a merge procedure, and intermediate-file cleanup. This batch-operation skill has explicit checkpoints and error-recovery classification ('Needs Manual Review'), matching anchor 5; not 4 because validation is present at every phase boundary. | 5 / 5 |
Progressive Disclosure | Section headers organize the body well, but ~290 lines of per-language reference material (prevention patterns, vulnerable/secure examples) are inlined in a single 570-line file with no bundle files, and Phase 2's manual '[TECH-STACK EXAMPLES]' selection is exactly what per-stack reference files would automate. Some structure with content that should be separate kept inline matches anchor 3; not 4 because there is no reference-file split at all, not 2 because sections are clearly headed and navigable rather than a wall of text. | 3 / 5 |
Total | 16 / 20 Passed |