Content
85%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 a well-sequenced, highly actionable narrative playbook with templates, examples, validation checklists, and a correction feedback loop. Its main defect is navigation: the referenced `templates/all-hands-template.md` is missing from the bundle, and the in-body Keywords section duplicates the frontmatter description.
Suggestions
Create `templates/all-hands-template.md` (or fix the path) — it is referenced in Step 5 and in the Detailed References list but does not exist in the bundle, leaving users who follow the reference at a dead end.
Remove the in-body 'Keywords' section; those trigger terms are already in the frontmatter description, so the section spends tokens without adding guidance.
Clarify the reference path for `references/narrative-frameworks.md` in the Detailed References list with a one-line description of what to use it for when (e.g., 'for SCR and Problem-Solution-Evidence structures when drafting updates').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific judgment (translation matrix, contradiction patterns, all-hands failure modes) and assumes Claude's intelligence without explaining basic communication concepts. Not a 5 because the 'Keywords' section duplicates trigger terms already present in the description's frontmatter, spending tokens on redundant content; not a 3 since everything else earns its place with only minor trimming possible. | 4 / 5 |
Actionability | Fully concrete, fill-in-ready guidance throughout: a copy-paste core narrative template with a worked good/bad example pair ('Acme Health exists to reduce preventable falls...' vs the buzzword version), a populated four-audience translation matrix, a 3-question contradiction-detection procedure, a cadence table with owners, and a copy-paste crisis communication template. Specific examples cover the common cases for this instruction-only skill. | 5 / 5 |
Workflow Clarity | Steps 1–6 are clearly sequenced (core narrative → translation → contradiction check → cadence → all-hands → crisis), with explicit validation checkpoints (the 'Narrative Consistency Checklist' and the pre-communication contradiction check) and a feedback loop for error recovery ('When you catch a contradiction: Fix the less accurate version, then communicate the correction explicitly'). No destructive/batch operations, so no cap applies. | 5 / 5 |
Progressive Disclosure | The 'Detailed References' section is clearly signaled and `references/narrative-frameworks.md` exists as a proper one-level-deep reference, but `templates/all-hands-template.md` — referenced twice (Step 5 and the reference list) — does not exist in the bundle, so half the outbound references are broken. Not a 4 because a user following the reference hits a dead end; not a 2 because structure and signaling of the remaining reference are good and the inline content is overview-level rather than a monolithic wall. | 3 / 5 |
Total | 17 / 20 Passed |