Content
63%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 well-structured, domain-competent skill body with a deterministic five-step workflow and genuine validation checkpoints, undermined by two issues: verbatim-level redundancy between 'When NOT to use'/'Distinct from' and between the Workflow and Scripts sections, and a bundle that omits every file the body depends on. The guidance itself is concrete and framework-anchored rather than fluffy.
Suggestions
Merge 'When NOT to use' with 'Distinct from' (they cover the same sibling skills twice), and let the Workflow steps carry tool behavior so the Scripts section only documents flags/outputs — this alone would remove ~30 lines of duplication.
Ship the referenced bundle files (scripts/comms_template_filler.py, scripts/change_announcement_builder.py, scripts/comms_calendar_builder.py, references/announcement_anti_patterns.md, and the canon/asset files) or inline minimal versions; the workflow's step 5 and the Quick example currently point at files that don't exist.
Close the feedback loop in step 5: state what to do when the anti-pattern sweep fails (e.g., 'regenerate with change_announcement_builder.py at the corrected magnitude and re-run the sweep before publishing').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body has real duplication beyond 'minor trim' level: 'When NOT to use' and 'Distinct from' list the same sibling skills (marketing-skill, c-level-advisor/change-management, c-level-advisor/internal-narrative) with overlapping rationale, and the 'Scripts' section re-describes the three tools already characterized in Workflow steps 2–4. The Purpose section's four failure modes are also partly rhetorical. It stays above a 2 because nothing explains basics Claude already knows — the ADKAR/Kotter content is applied skill-specifically (magnitude/tone rules, touchpoint floors), not textbook summary. | 3 / 5 |
Actionability | Concrete and mostly executable: exact script names with flags ('--profile <industry>', '--input <json>', '--output {markdown,json}', '--sample'), a runnable Quick example command, and a precise 8-item anti-pattern checklist. Not a 5 because the intake step defers entirely to 'assets/comms_brief_template.md and its JSON skeleton' with no inline example, and the example command's cd path ('business-operations/skills/internal-comms') assumes a repo layout the bundle doesn't define. | 4 / 5 |
Workflow Clarity | 'Five-step deterministic flow. Follow in order.' gives a clear sequence, each step names its tool, and steps 2–5 embed validation (magnitude/tone checks, gap surfacing, the anti-pattern sweep: 'The 8 anti-patterns listed there are non-negotiable; any one of them is a "do not send" signal'). Not a 5 because there is no explicit error-recovery branch: what to do when the anti-pattern sweep fails or a gap is surfaced (re-run which tool with what change) is left implicit. This is not a destructive/batch operation, so the workflow-clarity cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | The markdown is well-sectioned and references are clearly signaled one level deep ('references/announcement_anti_patterns.md', three scripts, one asset template), but the bundle contains no references/, scripts/, or assets/ directories — all seven referenced paths are dead. Scored against the actual bundle structure per the judging guidelines, the disclosure chain is broken: the anti-pattern sweep, the JSON skeleton, and the runnable example all depend on files that do not ship with the skill. | 3 / 5 |
Total | 14 / 20 Passed |