Content
88%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.
The body is lean, fully executable, and sequenced with explicit pre-checks, done-when criteria, and error fallbacks for both the run and teach paths. The one material weakness is progressive disclosure: the Learn half depends on references/docs/, which is absent from the bundle, so the referenced detail cannot actually be reached.
Suggestions
Ship the references/docs/ pages that SKILL.md and curriculum.md point to (index.mdx, cli/index.mdx, agents/*.mdx, etc.), or trim the references and curriculum table to only files that exist in the bundle.
State in the Teaching section what to do when references/docs/ is unavailable beyond the generic missing-page fallback, so the Learn path degrades gracefully instead of dead-ending at curriculum.md.
Consider noting in SKILL.md that the bundle is incomplete if docs are intentionally external, so a reader can distinguish a packaging gap from a broken reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout ("Execute `ywai …` yourself", "List before mutate. Confirm the id or name exists.", "Never enable or disable `core`"), with no explanation of concepts Claude already knows and every line carrying instruction. It matches the anchor of every token earning its place. | 5 / 5 |
Actionability | Concrete copy-paste commands cover every mutation ("ywai mcp enable <id>", "ywai profile use <name>", "ywai groups disable <name>"), the expected outputs are quoted in "Done when" ("MCP … enabled", "Active profile: …"), and the teaching procedure is a numbered, specific sequence. This matches the fully-executable top anchor. | 5 / 5 |
Workflow Clarity | Both workflows are fully sequenced with explicit validation and error feedback: pre-check ("List before mutate. Confirm the id or name exists."), post-check ("The command printed success … or you reported the error verbatim"), recovery for teaching ("If a page is missing or the read fails, say so and teach only what you successfully read"), plus the restart instruction after config changes. This matches the anchor with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | The overview-to-reference design is right (SKILL.md stays lean and clearly signals "Open [references/curriculum.md](references/curriculum.md)"), but scoring against the actual bundle, the primary referenced content is missing: neither the body's "Read only `references/docs/`" nor curriculum.md's ~15 paths under `references/docs/` exist in the bundle — only references/curriculum.md is present. The disclosure chain breaks for the skill's entire Learn half, which is a more severe defect than the "not clearly signaled" anchor 3 example and lands noticeably below the midpoint. | 2 / 5 |
Total | 17 / 20 Passed |