Skill

Experiment

Settle subjective questions by blind, evidence-driven comparison.

Use in Claude Code
/attune:experiment

When a question can only be answered by trying (not by research or direct user knowledge), this skill runs a controlled experiment. It frames a single criterion, produces 2–4 candidates (at least one by the main agent, the rest by pinned external agents), blinds them by shuffling and stripping provenance, and sends them to 2–3 different external judges for ranking with justification. The user receives the anonymized candidates and verdicts, rules on the winner, and only then sees the provenance mapping. The experimental directory is deleted as cleanup.

Key Insights

Single Criterion

Every experiment has exactly one criterion that the candidates compete on. A candidate set without a criterion is taste-polling, not an experiment.

Provenance Stripping

Candidates are shuffled into letter-named files (A, B, …) with all provenance hints removed. The letter-to-producer mapping is written to mapping.txt and never shown before the ruling.

External Judge Panel

2–3 different external agents, pinned by model, each receive the blinded candidates and criterion. Every judge ranks the candidates and justifies its ranking in two sentences.

Safe External Production

External agents never write to a repo directly. When a future experiment needs repo access, a git worktree is created first; changes are collected via worktree diff, merging stays an explicit main-thread step.

How It Works

1

Frame & Produce

Name the experiment and write the criterion. Produce 2–4 candidates.

Name the experiment (kebab-case) and define the single criterion. Render 2–4 candidates into a temp directory, producing at least one yourself and dispatching external-agent briefs for the rest.

2

Blind

Shuffle, strip provenance, write mapping.

Copy candidates to letter-named files (A, B, …) in shuffled order, stripping all provenance hints. Write the letter-to-producer mapping to mapping.txt.

3

Judge

Send blinded candidates to 2–3 external judges in parallel.

Each judge receives the letter-named candidates and the criterion via an external-agent brief (pinned by model, tagged auditing). Each ranks and justifies in two sentences.

4

Rule & Conclude

Present verdicts, user rules, reveal mapping, clean up.

Show the candidates and anonymized verdicts to the user. The user rules. Reveal the provenance mapping only after the ruling, report the outcome, then delete the experiment directory.