CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ralph-skill-review-loop

Self-improving review loop for Ralph Wiggum skills. Reviews skills against best practices, implements improvements, and continues until two consecutive clean reviews. Use when validating or improving the ralph-prompt-* skill suite.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced review loop with excellent workflow checkpoints and fully executable commands, but it is significantly bloated and monolithic: speculative and explanatory sections pad the token budget, and the entire prompt payload is inlined where a one-level-deep reference file would serve better.

Suggestions

Move the ~400-line review-loop prompt into a single reference file (e.g. references/review-loop-prompt.md) and keep SKILL.md to the overview, quick start, state-file initialization, and a clearly signaled pointer to the prompt file.

Delete the padding sections: 'Why This Works', 'Expected Behavior' (speculative iteration-phase ranges), and 'Customization' — none contain instructions the executing agent needs.

Remove the duplicate criteria listing in 'REVIEW CRITERIA REFERENCE (Quick Check)' since the same 16 criteria already appear as checkboxes in Step 2, keeping only one canonical list.

DimensionReasoningScore

Conciseness

The body runs ~540 lines with several padded sections that add no actionable information: 'Why This Works' explains the loop back to the reader, 'Expected Behavior' speculates iteration phases ('Iteration 1-5: Discovery phase... 26-40: Validation phase'), 'Customization' offers trivial one-liners, and the 16 review criteria are listed twice (once as checkboxes in Step 2, again verbatim in 'REVIEW CRITERIA REFERENCE'). This matches 'noticeably verbose; several unnecessary explanations or padded sections'. It is not a 1 because the core prompt template itself is dense and substantive, not generic concept explanation.

2 / 5

Actionability

Everything is copy-paste executable: the full bash invocation with flags ('/ralph-wiggum:ralph-loop "..." --completion-promise "RALPH_SKILLS_PERFECTED" --max-iterations 100'), heredoc commands to initialize the state files, jq commands to query state, a git commit message template, and complete JSON/markdown file templates. This matches 'fully executable; copy-paste ready code or commands'. Not a 4 because there are no meaningful gaps — even the monitoring and post-completion steps have concrete commands.

5 / 5

Workflow Clarity

The loop is a clearly sequenced six-step process (orientation → review → implement → verify → update state → loop decision) with an explicit termination condition checked at two points, a post-improvement verification step with a syntax check command (Step 4.3), an error-recovery path (fix prioritization ordering, escape hatch after 50 iterations), and checklists throughout. This batch/improvement workflow does include validation steps, so the destructive/batch cap does not apply, and it matches the anchor requiring explicit validation steps, feedback loops, and checklists. Not a 4 because the Step 4 verification and escape hatch together close the loop rather than leaving minor gaps.

5 / 5

Progressive Disclosure

The body has clear section structure and headers, but the ~400-line embedded review-loop prompt is inlined wholesale in SKILL.md when it clearly belongs in a separate reference file, and the 16 criteria are duplicated in two sections. There is no bundle at all (no references/ directory), so the skill is effectively monolithic. This matches 'some structure but could be better organized; content that should be separate is inline'. Not a 2 because headers and a quick-start section do provide real navigational structure, and the one external reference to RALPH-WIGGUM-TECHNIQUE-COMPREHENSIVE-RESEARCH.md is signaled inline with its scope.

3 / 5

Total

15

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states what the skill does and when to use it, with an explicit trigger clause and highly distinctive domain naming. Its only weakness is modest keyword coverage — a few natural phrasings a user might actually say are absent.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Reviews skills against best practices, implements improvements, and continues until two consecutive clean reviews' — with the termination condition made explicit. It falls short of a 5 because 'skills' and 'best practices' leave the artifact being reviewed slightly abstract compared to the full coverage of the anchor example.

4 / 5

Completeness

It explicitly answers both questions: what ('reviews skills against best practices, implements improvements, and continues until two consecutive clean reviews') and when ('Use when validating or improving the ralph-prompt-* skill suite'), matching the anchor that requires concrete trigger phrases for both. Not below 4 because the 'when' clause is explicit, not merely implied.

5 / 5

Trigger Term Quality

The 'Use when' clause supplies natural trigger phrases ('validating or improving the ralph-prompt-* skill suite') plus the distinctive 'Ralph Wiggum skills' keyword. A few natural variations users might say — e.g. 'skill review', 'fix my ralph skills', 'audit skills' — are missing, so it does not reach comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — 'Ralph Wiggum skills' and 'ralph-prompt-* skill suite' name a highly specific target suite, so risk of triggering for a generic skill-review or code-review request is minimal. It uses third-person voice throughout ('Reviews', 'implements', 'continues'), so no voice penalty applies.

5 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (539 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/ralph-skill-review-loop/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.