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.
Highly actionable with a complete template, worked examples, and a concrete integration command, but the file is padded: the second example, philosophy section, and DO/DON'T lists duplicate the template and best-practices content. Moving examples to a reference file would fix both the verbosity and the monolithic structure.
Suggestions
Move the two full worked examples to references/examples.md and keep one condensed example inline, cutting the body by roughly half.
Delete the 'Ralph Philosophy' paragraph and merge the DO/DON'T and 'Best Practices' lists into the existing workflow steps to remove duplicated guidance.
Add a final verification step to the generation workflow, e.g., confirm every task appears in exactly one phase and all listed dependencies resolve to earlier tasks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Of ~575 lines, roughly 300 are two fully worked examples (CRUD, CI/CD) that largely restate the 145-line template, and the 'Ralph Philosophy' paragraph plus DO/DON'T/Best Practices sections repeat guidance already embedded in the workflow. This is noticeably verbose with several padded sections — the 2 anchor — rather than merely 'could be tightened'. | 2 / 5 |
Actionability | The skill provides a copy-paste-ready prompt template, two completely filled-in example prompts, an exact invocation command ('/ralph-wiggum:ralph-loop "..." --completion-promise ... --max-iterations 50') with iteration counts by task complexity. Guidance is fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | The four-step generation workflow (map tasks, define phases, create milestones, structure prompt) is clearly sequenced, and the generated-prompt template embeds explicit checkpoints, success criteria, and 'If Stuck' recovery guidance. Not 5 because the generation workflow itself lacks a final validation step (e.g., verifying every task maps to a phase and dependencies resolve). | 4 / 5 |
Progressive Disclosure | The body has good section headers and one-level pointers to sibling skills (ralph-prompt-single-task, ralph-prompt-project, ralph-prompt-research), but there are no bundle files at all — the 300+ lines of worked examples that clearly belong in a references/examples file are inlined in SKILL.md. Structure exists but content that should be separate is inline — the 3 anchor. | 3 / 5 |
Total | 14 / 20 Passed |