Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, highly actionable playbook with executable commands and a strong query table, weakened only by the absence of explicit validation checkpoints around ingest and the promote/batch step, and by being a single monolithic file rather than a tiered reference structure.
Suggestions
Add explicit validation checkpoints: after ingest, verify node/edge counts before querying (e.g., 'Run kg_query(kind="count") and confirm User/Computer nodes exist before running attack-path queries'), and after promoting a path, confirm the attack_path node was added.
Consider splitting the canonical Cypher query table and the CVSS/impact table into a one-level-deep reference file (e.g., CYPHER_QUERIES.md) so SKILL.md stays a lean overview pointing to detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it never explains what BloodHound, Active Directory, or Cypher are, and every table and command earns its place, matching the 'lean and efficient; every token earns its place' anchor. | 3 / 3 |
Actionability | It provides copy-paste-ready commands (bloodhound-python invocation, bh_ingest_zip, bh_cypher) and a full table of executable Cypher queries; placeholders like USER/PASS and <owned-user> are appropriately parameterized rather than vague pseudocode, matching the 'fully executable; copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | The Collect → Ingest → Query → Prioritize → Promote sequence is clear and section 6 provides failure fixes, but there is no explicit validation checkpoint after ingest or before/after the batch 'promote findings' step, so per the feedback-loops scoring note workflow clarity is capped at 2. | 2 / 3 |
Progressive Disclosure | The content is well-organized into clearly headed sections with tables and no nested references, but it is a monolithic single-file body (~75 lines) rather than an overview pointing to one-level-deep detail files, so it lands at 'some structure but content that should be separate is inline'. | 2 / 3 |
Total | 10 / 12 Passed |