Skip to content
cccskills
FreePublished on GitHub

ralph

Iterative measurement-driven improvement loop. Measure, profile, mutate, re-measure, commit. Works for performance, bundle size, complexity, test coverage — anything quantifiable. Use when the user wants to systematically improve a metric through repeated cycles of profiling and targeted changes.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Ralph

Iterative measurement-driven improvement loop. Each cycle: measure → profile → find biggest contributor → mutate → re-measure → commit only if improvement exceeds noise.

0. Gather inputs

Use AskUserQuestion to collect:

  1. What to improve — target metric and direction
  2. How to measure — command or method (research and propose one if user doesn't know)
  3. How many cycles — default 20
  4. Constraints — what must NOT change

1. Setup

  • Create a feature branch and draft PR early (load forge-pr skill for title/body). PR description includes a measurements table updated as cycles complete.
  • Baseline: measure at least 5 runs, report median. For time: distinguish cold (no cache) from hot (cached). Document methodology.
  • Create docs/<target>-ralph-report.md with baseline, methodology, optimization log table, and findings.
  • Seed TaskCreate list with N cycle tasks — emit all calls as parallel tool_use blocks in a single assistant turn so the seed is one model round-trip, not N.

2. The loop

Each cycle:

  1. Profile — break down the metric into components. Measure each independently. Don't guess.
  2. Classify — categorize the biggest contributor (unnecessary dep, eager eval, redundant work, wrong abstraction, missing cache, structural overhead).
  3. Mutate — single, targeted change addressing the biggest contributor.
  4. Re-measure — same benchmark, same methodology. If improvement is within noise (<3% for time), don't commit — document in report only.
  5. Commit + push — only if improvement exceeds noise. Include metrics in commit message. Push report file with each commit.

3. Wrap-up

  • Final measurement with same methodology as baseline — this is the number for the PR.
  • Update PR description with final before/after table, summary of changes, key findings.
  • Complete report with optimization log, dead ends ("Investigated but no improvement"), key findings, and cost breakdown.
  • Run CI to verify nothing is broken.

Rules

  • Facts over opinions. Measure everything. Don't commit based on theory.
  • One change per cycle. Isolate variables.
  • Only commit improvements. Noise-level changes clutter history.
  • Preserve behaviour. All changes behaviour-preserving unless user explicitly allows otherwise.
  • Document dead ends. "X doesn't help" is valuable knowledge.
  • Stop at diminishing returns. 3 consecutive no-improvement cycles → tell user and stop.
  • Keep the report. The .md is a deliverable — useful for blog posts and future reference.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

be

Free

Modern, interactive alternative to `/do` — clarify intent up front, then take a task end-to-end with a serial AI review gauntlet (lens debate (lowy ⇄ hickey) → codex debate → simplify → code-police, each editing the branch in turn) → CI → evidence. ONLY invoke when the user explicitly types `/be` or `$be`; never auto-select from a natural-language request.

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

Run /be's review gauntlet SERIALLY — /lens-debate (lowy ⇄ hickey), then /codex-debate, then /simplify, then code-police, each editing and committing on the live branch in turn. Use from /be §4, or when the user asks to "run the review gauntlet". Requires Claude Code's Skill tool.

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

ci

Free

Reference for the `odu` runner — how to invoke a full pipeline, a single recipe, or a platform-pinned node, and how to attach to a live run, from a project whose CI odu runs. Trigger when the user asks to "run CI", "run the pipeline", "re-run a check", to run named lanes or recipes (e.g. "run fmt and nix", "just the e2e lane", bare selectors like `fmt`/`nix`/`e2e`), or names a recipe by `<recipe>@<platform>`. This skill — not a repo's local `just ci` / `just <recipe>` — is how an odu-run request is served.

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

Review code for quality, simplicity, and common mistakes before declaring work complete.

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

Run an automated codex⇄Claude debate to consensus — no round cap, no deadlock exit. Two explicit subcommands. `review` (also the bare/back-compat default) — codex (reviewer) critiques the current diff and a Claude subagent (author) fixes/disputes, looping until they agree. `answer` — Claude and codex each answer a freeform prompt in parallel, then cross-check until they agree, and a unified answer is returned. Use when the user types `/codex-debate`, asks to "have codex review this", "run the codex debate", "review this PR with codex", "argue this with codex until you agree", or passes a question to "have Claude and codex debate/answer until they agree".

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

do

Free

Do a task end-to-end — implement, PR, CI loop, ship. ONLY invoke when the user explicitly types `/do` or `$do`; never auto-select from a natural-language request, even one that sounds like an end-to-end task.

The English summary is being prepared. Showing the original description.

srid/emanote966Updated Jul 26, 2026

See all skills by srid

Report a problem with this skill