Content
100%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 exemplary instruction-only skill body: tight, concrete, and well-structured. It gives executable specifics (path patterns, prefixes, scripts, budgets, stopping criteria) without over-explaining, and delegates persona detail to real one-level-deep reference files. No dimension shows more than nit-level room for improvement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~100-line body is lean and assumes Claude's competence: no explanation of what interviewing is, a table instead of prose for persona routing, and every rule carries its own one-line justification that shapes judgment (e.g., "Two questions get half of each"). Nothing reads as padding, matching the level-5 anchor rather than the level-4 'minor instances of over-explanation'. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a transcript path pattern (`transcripts/YYYY-MM-DD-<slug>.md`), a persona-prefix example (`**Terkel:**`), a verbatim closing-move script to quote, a twelve-question ceiling, named cross-skill handoffs (`research`, `voice`, `drafting`), and per-persona follow-up triggers delegated to the persona files. The guidance is concrete and specific throughout, so the absence of code is not penalized. | 5 / 5 |
Workflow Clarity | The process is clearly sequenced — brief first if needed, one question at a time, route follow-ups by persona triggers, stop on the three-item checklist ("concrete story or artifact", "unguarded position", "hook material"), transcript written as you go, closing move, then hand off. The stopping checklist and the completion condition ("The interview isn't done until at least one concrete story or artifact is on the record") act as explicit validation checkpoints, satisfying the level-5 anchor; this is not a destructive or batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview and the six persona files (verified present in references/personas/) are exactly one level deep, linked by name in a routing table and a per-seat purpose list. Detail that would bloat the body (persona voice, question patterns) correctly lives in the bundle files, matching the level-5 anchor of well-signaled, one-level-deep references. | 5 / 5 |
Total | 20 / 20 Passed |