Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is concise and well-organized as a tactical attack catalog, but it stays mostly descriptive with a procedural probe flow and no executable scripts or external reference files, which limits actionability, workflow feedback, and progressive disclosure.
Suggestions
Add executable probe scripts (e.g., a script that uploads a canary doc, issues a query, and asserts canary execution) to move actionability toward copy-paste-ready.
Add an explicit validate→fix→retry feedback loop in the probe workflow so failed canary detection drives a corrective next step.
Move the per-technique details (T12.001–T12.007) into a one-level-deep reference file, keeping SKILL.md as an overview, to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and terse — short bullets, a one-line RAG definition, and minimal explanation of concepts Claude already knows — so it matches the 'lean and efficient; assumes Claude's competence' anchor rather than the padded/mostly-efficient levels below. | 3 / 3 |
Actionability | It provides some concrete guidance (a copy-paste YAML probe block and a 3-step poison-doc submission flow), but the submission flow is procedural rather than executable code/commands and lacks runnable scripts, fitting 'some concrete guidance but incomplete; pseudocode instead of executable code'. | 2 / 3 |
Workflow Clarity | The custom probe lays out a clear upload→query→check sequence, but the 'check if canary executed' step has no fix/retry feedback loop or explicit validation checkpoint, matching 'steps listed but validation gaps; checkpoints missing or implicit'. | 2 / 3 |
Progressive Disclosure | The skill is a single well-sectioned file with no nested references, but seven detailed technique writeups plus severity/detection tables are kept inline with no bundle files or one-level-deep reference split, fitting 'some structure but content that should be separate is inline'. | 2 / 3 |
Total | 9 / 12 Passed |