Customization
Before executing, check for user customizations at: ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/Science/
If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.
🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)
You MUST send this notification BEFORE doing anything else when this skill is invoked.
- Send voice notification:
curl -s -X POST http://localhost:8888/notify \ -H "Content-Type: application/json" \ -d '{"message": "Running the WORKFLOWNAME workflow in the Science skill to ACTION"}' \ > /dev/null 2>&1 & - Output text notification:
Running the **WorkflowName** workflow in the **Science** skill to ACTION...
This is not optional. Execute this curl command immediately upon skill invocation.
Science - The Universal Algorithm
The scientific method applied to everything. The meta-skill that governs all other skills.
The Universal Cycle
GOAL -----> What does success look like?
|
OBSERVE --> What is the current state?
|
HYPOTHESIZE -> What might work? (Generate MULTIPLE)
|
EXPERIMENT -> Design and run the test
|
MEASURE --> What happened? (Data collection)
|
ANALYZE --> How does it compare to the goal?
|
ITERATE --> Adjust hypothesis and repeat
|
+------> Back to HYPOTHESIZEThe goal is CRITICAL. Without clear success criteria, you cannot judge results.
Workflow Routing
Output when executing: Running the **WorkflowName** workflow in the **Science** skill to ACTION...
Core Workflows
| Trigger | Workflow |
|---|---|
| "define the goal", "what are we trying to achieve" | Workflows/DefineGoal.md |
| "what might work", "ideas", "hypotheses" | Workflows/GenerateHypotheses.md |
| "how do we test", "experiment design" | Workflows/DesignExperiment.md |
| "what happened", "measure", "results" | Workflows/MeasureResults.md |
| "analyze", "compare to goal" | Workflows/AnalyzeResults.md |
| "iterate", "try again", "next cycle" | Workflows/Iterate.md |
| Full structured cycle | Workflows/FullCycle.md |
Diagnostic Workflows
| Trigger | Workflow |
|---|---|
| Quick debugging (15-min rule) | Workflows/QuickDiagnosis.md |
| Complex investigation | Workflows/StructuredInvestigation.md |
Resource Index
| Resource | Description |
|---|---|
METHODOLOGY.md | Deep dive into each phase |
Protocol.md | How skills implement Science |
Templates.md | Goal, Hypothesis, Experiment, Results templates |
Examples.md | Worked examples across scales |
Domain Applications
| Domain | Manifestation | Related Skill |
|---|---|---|
| Coding | TDD (Red-Green-Refactor) | Development |
| Products | MVP -> Measure -> Iterate | Development |
| Research | Question -> Study -> Analyze | Research |
| Prompts | Prompt -> Eval -> Iterate | Evals |
| Decisions | Options -> Council -> Choose | Council |
Scale of Application
| Level | Cycle Time | Example |
|---|---|---|
| Micro | Minutes | TDD: test, code, refactor |
| Meso | Hours-Days | Feature: spec, implement, validate |
| Macro | Weeks-Months | Product: MVP, launch, measure PMF |
Integration Points
| Phase | Skills to Invoke |
|---|---|
| Goal | Council for validation |
| Observe | Research for context |
| Hypothesize | Council for ideas, RedTeam for stress-test |
| Experiment | Development (Worktrees) for parallel tests |
| Measure | Evals for structured measurement |
| Analyze | Council for multi-perspective analysis |
Key Principles (Quick Reference)
- Goal-First - Define success before starting
- Hypothesis Plurality - NEVER just one idea (minimum 3)
- Minimum Viable Experiments - Smallest test that teaches
- Falsifiability - Experiments must be able to fail
- Measure What Matters - Only goal-relevant data
- Honest Analysis - Compare to goal, not expectations
- Rapid Iteration - Cycle speed > perfect experiments
Anti-Patterns
| Bad | Good |
|---|---|
| "Make it better" | "Reduce load time from 3s to 1s" |
| "I think X will work" | "Here are 3 approaches: X, Y, Z" |
| "Prove I'm right" | "Design test that could disprove" |
| "Pretend failure didn't happen" | "What did we learn?" |
| "Keep experimenting forever" | "Ship and learn from production" |
Quick Start
- Goal - What does success look like?
- Observe - What do we know?
- Hypothesize - At least 3 ideas
- Experiment - Minimum viable tests
- Measure - Collect goal-relevant data
- Analyze - Compare to success criteria
- Iterate - Adjust and repeat
The answer emerges from the cycle, not from guessing.