Content
83%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.
An exceptionally actionable and token-efficient playbook with a clear step sequence; the main gap is the absence of explicit validation/verification checkpoints between the batch write operations (ingest, promote), which caps workflow clarity.
Suggestions
Add a validation checkpoint after ingest (e.g., verify expected node counts with a quick Cypher count query) before running enumeration queries.
Add a verification step after plan_attack_chains / kg_add_node promotion (e.g., confirm the attack_path node exists and is linked to the crown-jewel target) so the batch write can be confirmed before reporting.
Consider moving the 12-row canonical-query table into a references/ file (e.g., QUERIES.md) to keep SKILL.md as a leaner overview, which would also let progressive disclosure reach 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — code blocks and tables only, no padding explaining what BloodHound/AD/Cypher are; assumes Claude's competence and every line earns its place, matching the 5 anchor. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: the bloodhound-python collector command, bh_ingest_zip, a 12-row table of canonical Cypher queries, plan_attack_chains, and kg_add_node/edge calls cover the common cases concretely. | 5 / 5 |
Workflow Clarity | Steps are clearly sequenced (Collect → Ingest → Query → Auto-prioritize → Promote → Troubleshoot) and the collector-failure table is a feedback loop, but the workflow involves batch/database-style writes (ingest, kg_add_node/edge) with no validation checkpoint verifying ingest succeeded or findings were promoted correctly; per the rubric cap, missing validation in batch/database operations caps this at 3. | 3 / 5 |
Progressive Disclosure | A single self-contained file with well-organized numbered sections and tables, no nested or buried references and no external files needed; not a 5 because the large canonical-query table is somewhat over 50 lines and could plausibly be split into a reference file, leaving minor organization room. | 4 / 5 |
Total | 17 / 20 Passed |