CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ralph-prompt-builder

Master orchestrator for generating Ralph Wiggum-compatible prompts. Analyzes task requirements and routes to appropriate generator (single-task, multi-task, project, or research). Use when you need to create any Ralph loop prompt and want automatic selection of the right generator.

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/ralph-prompt-builder/SKILL.md

The canonical home for this skill is ralph-prompt-builder in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The body is well-organized and genuinely actionable — real commands, templates, checklists, and a sensible five-step workflow — but it is roughly three times longer than an orchestrator needs to be. Classification logic is repeated in four forms and the generator summaries duplicate the specialized skills they point to, with no use of reference files to shed any of it.

Suggestions

Collapse the four presentations of classification (routing table, classification questions, example lists, decision tree) into one — the decision tree plus one compact example row per type — cutting roughly 100 lines.

Trim each 'Generator Summaries' section to purpose + recommended iterations (3-4 lines), deferring structure and best-practice detail to the sibling generator skills themselves or a single references/generators.md file.

Merge 'Common Patterns' and 'Troubleshooting' into one short section, keeping only the max-iterations table and the four task-won't-complete fixes.

DimensionReasoningScore

Conciseness

The 435-line body is noticeably verbose: task classification is presented four separate ways (routing table, classification questions, 20 example bullet lines, and a decision tree), and the four 'Generator Summaries' sections restate each sibling skill's purpose, structure, best practices, and iteration counts — content that belongs in those skills' own files. Not a 1 because it does not pad with concepts Claude already knows (no 'what is a loop' tutoring), but well above the lean threshold of 4-5.

2 / 5

Actionability

Concrete, executable guidance dominates: the actual command "/ralph-wiggum:ralph-loop \"[generated prompt]\" --completion-promise \"[YOUR_PROMISE]\" --max-iterations [recommended]", a filled-in task template, an explicit classification output format, a max-iterations table, and input/output checklists. Minor gaps — the classification step's output is a template Claude must improvise around, and 'Guide you through required inputs' is high-level — keep it below fully copy-paste-ready coverage of the common cases.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with checkpoints: Step 2 forces an explicit classification confirmation (a feedback loop with the user), Step 4 is a review pass, and Input/Output checklists plus a Troubleshooting section (symptoms → causes → fixes) cover error recovery. Not a 5 because validation is advisory prose ('Verify requirements are complete') rather than explicit executable validation steps, and there is no verify-then-retry loop for the generated prompt itself.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so everything — classification examples, per-generator structures, iteration tables, troubleshooting — is inlined in one 435-line SKILL.md. Section headers are clear (better than the 'minimal structure' of a 2), but substantial content that clearly belongs in one-level-deep reference files (e.g., per-generator detail, classification example banks) is inline, matching the anchor-3 pattern.

3 / 5

Total

13

/

20

Passed

Description

78%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 in correct third-person voice: it states the orchestrator role concretely, lists the four routing targets, and includes an explicit 'Use when...' trigger clause. Its only weaknesses are modest sibling-skill overlap (inherent to an orchestrator) and action coverage that stops at classify-and-route.

DimensionReasoningScore

Specificity

"Analyzes task requirements and routes to appropriate generator (single-task, multi-task, project, or research)" names the domain and two concrete actions (analyze, route) with the four generator types, but does not enumerate what the generators produce or cover downstream actions like iteration guidance — matching the '1-2 concrete actions, not comprehensive' anchor. Not a 4 because it does not list several distinct specific actions beyond analyze-and-route.

3 / 5

Completeness

It explicitly answers both questions: what ("Master orchestrator for generating Ralph Wiggum-compatible prompts... routes to appropriate generator") and when ("Use when you need to create any Ralph loop prompt and want automatic selection of the right generator") with a concrete trigger phrase, matching the anchor-5 example pattern. Not a 4 because the 'when' clause is already explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — "create any Ralph loop prompt", "Ralph Wiggum", "generator", "task" — words a user of this technique would actually say. A few natural variations (e.g., "build a ralph prompt", "write a prompt for the loop") are not covered, matching 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The niche (Ralph loop prompt construction) is clear and triggers are distinct, but the description would fire for any Ralph prompt request that the four sibling generators (ralph-prompt-single-task, etc.) also target — 'mostly distinct; minor overlap risk with closely related skills'. Not a 5 because that sibling overlap is real, though intentional for an orchestrator.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/ralph-prompt-builder/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.