Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, interactive single-purpose skill with clear sequencing and clean progressive disclosure, weakened by some redundant/conceptual padding and the absence of any validation step for the generated artifact.
Suggestions
Remove the 'An epic represents a large body of work...' definitional sentence and deduplicate the get-date and read-template-fresh items that appear in both Constraints and Workflow.
Inline the core question template (or a compact summary of it) so the gather step is actionable without requiring the reference, or explicitly state which reference section to read at step 1.
Add a validation checkpoint after step 2 — e.g., confirm every required section and date placeholder is present in the generated epic before delivering it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with clear sections, but explains what an epic is ('An epic represents a large body of work...') that Claude already knows, and the Constraints and Workflow steps redundantly repeat the same MANDATORY/MUST items (get date, read template fresh). | 2 / 3 |
Actionability | Gives a concrete command (`date`) and names required document sections, but the actual question content is delegated to the reference and the generate step stays high-level ('Create the epic Markdown with all required sections'), so it is not fully copy-paste ready. | 2 / 3 |
Workflow Clarity | A clear 0→3 sequence with explicit wait-for-response checkpoints is present, but there is no validation or feedback loop verifying the generated epic, leaving the validation dimension the rubric associates with score 3 unmet. | 2 / 3 |
Progressive Disclosure | The body is a concise overview with well-organized sections and a single one-level-deep, clearly signaled reference (references/012-agile-epic.md) that exists in the bundle, matching the score-3 anchor. | 3 / 3 |
Total | 9 / 12 Passed |