Content
65%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.
This is a highly actionable knowledge base: concrete templates, exact commands, explicit schemas, and a sound file organization make the guidance immediately executable. Its weaknesses are structural and economic — the workflow is implicit rather than sequenced with validation checkpoints, and the monolithic 550-line layout inlines reference material (MITRE tables, CVSS table, repeated frontmatter) that should live in bundle files or be deduplicated.
Suggestions
Add an explicit sequenced workflow with validation checkpoints, e.g.: 1. Select the phase template, 2. Fill all frontmatter fields, 3. Complete the Detection Gap Analysis table, 4. Save to findings/FIND-{NNN}.md with evidence in findings/evidence/, 5. Verify every box in the Evidence Collection Checklist before marking the finding done. This lifts workflow clarity from 3 toward 5.
Split reference material into bundle files — move the MITRE ATT&CK mapping tables, the CVSS v4.0 score table, and the per-phase templates into references/ (e.g. references/mitre-mapping.md, references/cvss-scores.md, references/templates/{credential-access,privesc,lateral,exfiltration}.md) and keep SKILL.md as a concise overview with one-level-deep links. This improves both progressive disclosure and token efficiency.
Deduplicate the shared YAML frontmatter schema: state the canonical schema once (the body already notes all templates share it) and show only the per-phase differences in each template, cutting ~45 lines of repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The templates, CVSS calibration table, file layout, and checklist are the skill's real payload and earn their tokens. But it could be tightened: the ~35-line MITRE ATT&CK mapping tables restate technique IDs and tools Claude already knows, the shared YAML frontmatter schema (explicitly noted as identical across templates) is repeated in full four times, and four complete worked templates could be one full example plus per-phase deltas. | 3 / 5 |
Actionability | Fully executable and copy-paste ready: exact frontmatter field schemas, exact commands (nanodump, impacket-psexec, pypykatz invocations), exact table formats, concrete file paths and naming conventions (findings/FIND-{NNN}.md, findings/evidence/FIND-{NNN}_{description}.txt), and specific CVSS v4.0 vectors. Every common case (cred access, privesc, lateral movement, exfiltration) has a worked example. | 5 / 5 |
Workflow Clarity | The content is organized by deliverable type rather than as an explicit reporting workflow; the sequence (pick template → fill finding → complete detection gap table → save to findings/FIND-{NNN}.md → verify against checklist) is implicit. The Evidence Collection Checklist provides a genuine verification mechanism, but no validation checkpoints (e.g., confirm detection gap table and frontmatter fields are complete before saving) are stated in the process itself. | 3 / 5 |
Progressive Disclosure | The body has clear numbered section structure and consistent internal navigation, but it is a single ~550-line monolith with no bundle files at all. Content that naturally belongs in separate reference files — the MITRE mapping tables, the CVSS score table, and the individual phase templates — is inlined in SKILL.md rather than split into references/ with one-level-deep links. | 3 / 5 |
Total | 14 / 20 Passed |