Content
75%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.
A lean, well-structured body with copy-paste install and run commands and a clear dimension table. The main weaknesses are redundancy between the intro/Overview/When-to-Use sections and report generation not being an explicit workflow step.
Suggestions
Merge or trim the overlap between the intro, Overview, and 'When to Use This Skill' sections (e.g., drop the intro sentence that restates the Overview) to reach anchor-5 conciseness.
Make report generation an explicit 'Step 3' noting the probe must complete first (e.g., 'After the 30-question probe finishes, run /xray-report'), tightening workflow clarity.
Give a concrete one-line example of the non-Claude MCP setup path (a sample JSON config snippet) so the 'other tools' instruction is as actionable as the Claude Code path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — no explanations of concepts Claude already knows, and sections like the Probe Dimensions table earn their tokens. Minor instances of over-explanation remain: the intro, Overview, and When to Use sections overlap ('Systematically probe an AI model's behavioral patterns...' vs. the Overview restating it), plus light marketing padding ('30 carefully designed probe questions'). This fits anchor 4 rather than 5, and is clearly above anchor 3's 'some unnecessary explanation'. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: 'pip install bdistill', 'claude mcp add bdistill -- bdistill-mcp', '/xray', '/xray --dimensions refusal', '/xray-report', plus natural-language MCP invocations. Minor gaps keep it at anchor 4: the non-Claude path is thin ('add bdistill-mcp as an MCP server in your project config') and there is no example of what a probe interaction looks like. | 4 / 5 |
Workflow Clarity | A clear two-step sequence (Install → Run the probe) with copy-paste commands; probing is non-destructive so the missing-validation cap does not apply. It is not a 5 because report generation is not an explicit labeled step and there is no note that the probe must complete before '/xray-report'; it is above anchor 3 because the sequence that is present is unambiguous and complete. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the ~75-line body is well-organized into clearly signaled sections (Overview, When to Use, How It Works, Probe Dimensions, Output, Best Practices). It fits anchor 4 rather than 5: the body exceeds the under-50-line simple-skill exception, and content such as the 30 probe questions or per-dimension detail could naturally live in a reference file; it is well above anchor 3's 'content that should be separate is inline'. | 4 / 5 |
Total | 16 / 20 Passed |