Content
92%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 tight, actionable conversational-workflow skill with excellent conciseness, copy-paste-ready tool usage, and a well-validated phased workflow. Its one real defect is bundle integrity: the referenced templates/SOUL.template.md is absent, so the generation step's primary input is unavailable.
Suggestions
Ship templates/SOUL.template.md in the bundle (or repoint both references to an existing file) — the Generation flow instructs Claude to read and adapt it, but the file is missing.
If the template is intentionally excluded, inline a brief outline of the SOUL.md structure in SKILL.md so the generation step is self-sufficient without the missing reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven — phase goals, extraction fields, and generation rules are delivered in compact tables and short behavioral directives with zero explanation of concepts Claude already knows. The occasional repetition of read-file instructions (tree annotations, "Before your first response, read both") is minor and functions as point-of-need reinforcement, so every token earns its place. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: an exact tool call signature (`setup_agent(soul="<full SOUL.md content>", description="<one-line description>")`), a concrete do/don't example for behavioral rules ("Write 'argue position, push back, speak truth not comfort' — not 'honest and brave'"), and ready-made confirmation phrases ("here's [Name] on paper — does this feel right?"). Specific examples cover the common conversational cases. | 5 / 5 |
Workflow Clarity | The four phases are clearly sequenced with goals and extraction targets per phase, skip/merge rules for early volunteers, an explicit generate-when-ready criterion, and a user-confirmation loop ("Iterate until the user confirms") plus tool-error recovery ("If setup_agent returns an error, report it to the user and do not claim success"). Explicit validation checkpoints and feedback loops match the anchor-5 example. | 5 / 5 |
Progressive Disclosure | The overall structure is good — SKILL.md stays an overview and detailed conversation strategies live one level deep in the clearly signaled `references/conversation-guide.md` — but the body depends on `templates/SOUL.template.md` ("Read before generating", "Adapt the SOUL.md template") and that file does not exist in the bundle, breaking navigation at the most critical step. A missing dependency file is more than the "minor organization gaps" of anchor 4, placing this at anchor 3. | 3 / 5 |
Total | 18 / 20 Passed |