CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

experimental-design

Designs experiments and studies BEFORE data is collected — choosing a design, randomizing, blocking, and laying out treatment combinations so results are interpretable. Use whenever someone is planning a study, asks how to assign subjects/samples to groups, mentions randomization, blocking, stratification, controls, factorial or fractional-factorial designs, design of experiments (DOE), screening many factors, response-surface optimization, crossover or repeated-measures or split-plot designs, cluster/group randomization, Latin squares, plate layouts, batch/run-order effects, replication vs. pseudoreplication, or sequential/adaptive/group-sequential designs. Trigger even for informal phrasings like "how should I set up this experiment", "how do I avoid confounding", "what's the best way to test these 6 factors", or "assign these mice to conditions". For computing the sample size or power once the design is chosen, use statistical-power; for analyzing data already collected, use statistical-analysis.

Quality

94%

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

85%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 well-engineered skill body: fully executable, verified code examples; a clear sequenced workflow with named validation checkpoints; and excellent progressive disclosure with real one-level-deep reference files. Its one weakness is token efficiency — the Overview and mistakes sections re-explain statistics fundamentals Claude already knows, and the version/citation sections carry dated detail that could be trimmed or relocated.

Suggestions

Trim the Overview's exposition of Fisher's principles to a three-item checklist of what to apply (randomize / replicate at the right level / block known nuisance), moving the conceptual why into references/randomization_and_blocking.md where it already elaborates.

Compress the 'mistakes that ruin studies' items to one-line patterns to avoid (e.g., 'Pseudoreplication: 100 cells per mouse is n=3, not n=300 — replicate at the level treatment is randomized'), keeping the detail in the already-existing reference files.

Move the version/date bookkeeping (pyDOE3 archive history, tested-version lists, Windows interpreter path, archive-environment advice) into a short 'Environment notes' or the Installation reference so the main body stays stable and lean.

DimensionReasoningScore

Conciseness

The body is mostly efficient and decision-oriented, but re-explains concepts a competent model already knows: the Overview walks through Fisher's principles ("assign treatments at random so that confounders... are balanced in expectation"), the mistakes section explains basics like "Evaporation and thermal gradients make plate edges differ", and the Installation/Resources sections carry version and date detail (pyDOE3 archived May 2026, tested-version lists, Windows interpreter paths). This is anchor 3's 'includes some unnecessary explanation or could be tightened' rather than anchor 4's 'minor instances', since the conceptual re-explanations span several sections.

3 / 5

Actionability

Both script sections give copy-paste-ready code with real arguments (e.g., `block_randomization(n=60, arms=["treatment", "control"], seed=42)`, `central_composite({"temp_C": (20, 60), "conc_mM": (1, 10)}, center=(2, 2), face="inscribed", seed=42)`) whose imports, function names, and keyword arguments all match the bundled scripts, plus install commands and CSV export. Specific examples cover the common randomization and DOE cases; this matches anchor 5, exceeding anchor 4 because the examples are verified-executable and comprehensive.

5 / 5

Workflow Clarity

The 8-step Workflow is clearly sequenced (state question/unit → list nuisance factors → pick design → decide replication → generate layout → randomize and verify → document → match analysis) with explicit validation checkpoints: step 6's "verify roster IDs, completed-block balance, range limits, and rank", the `arm_balance(sched)` sanity check, and "verify every ID exactly once". This matches anchor 5's 'explicit validation steps' rather than anchor 4, since checkpoints are named rather than implied; the destructive/batch cap does not apply as verification steps are present and the skill generates rather than destroys.

5 / 5

Progressive Disclosure

SKILL.md is a genuine overview: a decision tree for choosing a design, working examples for the two scripts, a mistakes checklist, and clearly signaled one-level-deep pointers ("→ references/randomization_and_blocking.md", etc.) with a Resources section repeating them. All four referenced files and both scripts exist on disk and the reference files contain no nested references. Content is appropriately split with easy navigation — the anchor 5 pattern, not anchor 4's 'minor organization gaps'.

5 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: third-person, concrete about what the skill does, with an explicit 'Use whenever' trigger clause, comprehensive natural keyword coverage including informal phrasings, and explicit routing to sibling skills for adjacent tasks. No padding despite its length — nearly every clause adds trigger or disambiguation value.

DimensionReasoningScore

Specificity

"Designs experiments and studies BEFORE data is collected — choosing a design, randomizing, blocking, and laying out treatment combinations so results are interpretable" lists multiple specific concrete actions (design choice, randomization, blocking, treatment layout) with comprehensive coverage of the skill's capabilities. It clearly matches the anchor 5 example pattern rather than anchor 4, since no meaningful action is missing.

5 / 5

Completeness

It explicitly answers both questions: the 'what' in the opening sentence (concrete design-time actions) and the 'when' via "Use whenever someone is planning a study..." with concrete trigger phrases, plus boundary routing to statistical-power and statistical-analysis. This matches anchor 5 exactly; it exceeds anchor 4 because the 'when' is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

The description covers natural terms exhaustively with synonyms: "randomization, blocking, stratification, controls, factorial or fractional-factorial designs, design of experiments (DOE), screening many factors, response-surface optimization, crossover or repeated-measures or split-plot designs, cluster/group randomization, Latin squares, plate layouts, batch/run-order effects, replication vs. pseudoreplication", plus informal phrasings users would actually say ("how should I set up this experiment", "assign these mice to conditions"). This is the anchor 5 'comprehensive coverage including synonyms' case, not anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

"BEFORE data is collected" carves out a clear niche, and the description actively disambiguates adjacent skills ("For computing the sample size or power once the design is chosen, use statistical-power; for analyzing data already collected, use statistical-analysis"), minimizing wrong-skill triggers. Distinct specialized triggers like pseudoreplication and split-plot designs place this firmly at anchor 5 rather than the minor-overlap anchor 4.

5 / 5

Total

20

/

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

K-Dense-AI/scientific-agent-skills

Path

skills/experimental-design/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.