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 exemplary operational skill body: fully executable commands, explicit mutation safety rules, concrete done-when criteria, and a disciplined one-page-per-turn teaching procedure, all in lean directive prose. The one real defect is bundle-level: the references/docs/ directory the entire teaching half depends on is missing from the skill bundle as shipped.
Suggestions
Ship the references/docs/ directory (index.mdx, cli/, agents/, guides/, workflows/, panel/, configuration/, etc.) referenced by both SKILL.md and curriculum.md, or trim the teaching section and curriculum to reference only files that exist in the bundle.
Add a one-line note in the Teaching section telling the reader to consult references/curriculum.md for the topic-shortcut table, so the shortcut mappings are discoverable without opening the file blind.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and purely directive ("Execute ywai … yourself. Do not paste the command for the user to copy.", "disable keeps the config") with zero explanation of concepts Claude already knows and no padding — every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | Copy-paste-ready command blocks for all three mutation areas (ywai mcp list/enable/disable/auth, ywai profile list/use, ywai groups enable/disable), a profile name/effect table, success-output criteria in "Done when", and example invocations (/learn-ywai agentes) — fully executable coverage of the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The run workflow has explicit validation checkpoints ("List before mutate. Confirm the id or name exists" plus the "Done when" success-or-report-error-verbatim criterion) and the teaching workflow is a numbered 5-step sequence with an explicit error-recovery fallback ("If a page is missing or the read fails, say so and teach only what you successfully read") — matching anchor 5's clear sequence with validation and feedback loops. | 5 / 5 |
Progressive Disclosure | Signaling and layering are well designed — SKILL.md stays an overview, commands are inlined appropriately, and teaching detail is deferred to a single clearly linked index (references/curriculum.md) one level deep. However, the primary referenced content tree references/docs/ (with its .mdx pages, which both the body and curriculum.md depend on) is absent from the actual bundle, so navigation to the teaching material fails — a bigger defect than anchor 4's minor organization gaps, though the clear signaling keeps it above anchor 3's buried references. | 3 / 5 |
Total | 18 / 20 Passed |