Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-sequenced with strong validation checkpoints and concrete, executable orchestration commands. Its main gaps are verbosity from duplicated invocation/report templates and a monolithic structure with no progressive disclosure despite exceeding the simple-skill line count.
Suggestions
Collapse the duplicated "How to invoke" blocks: pick the preferred form (slash-command or Task tool) and reference the alternative once instead of repeating both per phase.
Move the large final-report and RALPH HANDOFF templates into a references/ file (e.g. REPORT_TEMPLATES.md) and link to it, improving progressive disclosure and trimming the main body.
Tighten the repeated progress-report snippets into one parameterized template referenced from each phase rather than restating the format.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~190-line body avoids explaining concepts Claude already knows, but is padded by duplicated invocation forms (slash-command plus Task-tool variants) and repeated report/handoff templates that could be tightened; it is mostly efficient but not lean. | 2 / 3 |
Actionability | Provides concrete, runnable command forms throughout — "/ralph 1 --batch {batch_id} --type extract", Task-tool call templates, and "/archive-batch {batch_id}" — with specific placeholders rather than pseudocode, matching the copy-paste-ready anchor for an orchestration skill. | 3 / 3 |
Workflow Clarity | A clear six-phase sequence with an ASCII flow diagram and explicit validation checkpoints for this batch operation ("Do NOT proceed to archive" when tasks remain, verify-all-done-before-archive, per-phase failure handling and a resumability table) meets the explicit-validation-and-feedback-loops anchor. | 3 / 3 |
Progressive Disclosure | The skill is monolithic: no references/, scripts/, or assets/ bundle exists and all detail (report templates, handoff block, resumability table) is inline in a ~190-line SKILL.md, so structure is present but content that should be split out is not, fitting the mid anchor. | 2 / 3 |
Total | 10 / 12 Passed |