Agent skill

Stress Test

by ai-analyst-lab in ai-analyst-lab/ai-analyst

Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria.

MITAuto-check passedTesting & QA

Install Stress Test

skills CLI
$ npx skills add ai-analyst-lab/ai-analyst --skill stress-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ai-analyst-lab/ai-analyst stress-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ai-analyst-lab/ai-analyst.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/stress-test .claude/skills/stress-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
stress-test
GitHub stars
304
Token cost
~2.9k tokens
SKILL.md length
1,325 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria.

  • Works in 7 steps: Hypothesis Clarity → Baseline Validity → Survivorship Bias → …
  • Tasks that involve Load testing
  • SKILL.md covers Purpose, When to Use, Inputs and The 7-Point Stress Test, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Stress Test is an agent skill from ai-analyst-lab/ai-analyst. Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria. Use on /stress-test, "review / gut-check / stress test my analysis plan", or before committing significant time to a plan from any source. Produces a 7-point PASS/WARNING/FAIL diagnostic with an A-F grade.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Load testing. The repository describes itself as: AI Product Analyst — Claude Code-powered data analysis toolkit. The licence is MIT.

When your agent uses it

  • Tasks that involve Load testing

Example prompts

  • “review / gut-check / stress test my analysis plan”
  • “/stress-test”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Hypothesis Clarity
  2. Baseline Validity
  3. Survivorship Bias
  4. Segment Coverage
  5. Confound Identification
  6. Kill Criteria
  7. Output Alignment

What it can do on your machine

Read from SKILL.md and the folder at commit 52c0744. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Stress Test loads about 2.9k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 1,325 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ai-analyst-lab/ai-analyst at commit 52c0744, republished under its MIT licence (© ai-analyst-lab). 1,325 words, ~2,934 tokens.

Download SKILL.mdSave it as .claude/skills/stress-test/SKILL.md (or your agent's skills folder).
name
stress-test
description
Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria. Use on `/stress-test`, "review / gut-check / stress test my analysis plan", or before committing significant time to a plan from any source. Produces a 7-point PASS/WARNING/FAIL diagnostic with an A-F grade.

Skill: Stress Test

Type: Standalone — reviews any analysis plan for methodological flaws


Purpose

Takes an analysis plan, investigation design, or analytical approach and pressure-tests it for hidden flaws — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, and absent kill criteria. Acts as a "senior data scientist code review" for your analytical thinking.

This skill is standalone — it works on any analysis plan, whether produced by /analysis-design, written by the user, or pulled from an existing document.


When to Use

  • Before committing a week to executing an analysis plan
  • Before presenting an analysis design to stakeholders
  • When you've written an analysis brief and want a gut-check
  • When reviewing someone else's analytical approach
  • After an analysis came back with unexpected results (was the design flawed?)

Inputs

InputRequiredSourceDescription
{{PLAN}}YesUser or file pathThe analysis plan to review. Can be a file path, pasted text, or a description of the approach
{{CONTEXT}}NoUserBusiness context — what decision this analysis will inform
{{AUDIENCE}}NoUserWho will consume the results (affects what counts as "fatal" vs. "nice to have")
{{DATA_DESCRIPTION}}NoUserDescription of available data, if not obvious from the plan

The 7-Point Stress Test

Check data availability first. A methodologically perfect plan that needs data the dataset lacks is unexecutable, so this check precedes the seven checkpoints:

  1. Read the active dataset schema (.knowledge/datasets/{active}/schema.md)
  2. Check if the plan's required fields/tables/dimensions exist in the dataset
  3. If ANY required data is missing → HALT, skip checkpoints 1-6, jump straight to checkpoint 7, assign FAIL verdict with BLOCKER status, provide F grade, and stop
  4. If all required data exists → proceed with checkpoints 1-7 in order

Common data blockers to check for:

  • Plan requires device/platform segmentation → check if device, platform, or user_agent fields exist
  • Plan requires funnel analysis → check if event-level tracking exists (page views, clicks, sessions)
  • Plan requires traffic source attribution → check if source, medium, campaign, or referrer fields exist
  • Plan requires geographic segmentation → check if country, region, city, or geo fields exist
  • Plan assumes conversion rate → check if both numerator (orders, signups) AND denominator (sessions, page views) data exist

After confirming data availability, review the plan against each checkpoint. For each one, assign a verdict: PASS, WARNING, or FAIL.

1. Hypothesis Clarity

Check: Is there a specific, testable hypothesis? Or is this a fishing expedition?

VerdictCriteria
PASSHypothesis is falsifiable with a clear claim about cause and effect
WARNINGHypothesis exists but is vague ("engagement is down") or has multiple interpretations
FAILNo hypothesis — plan is "explore the data and see what we find"

Fix if FAIL: "State what you expect to find AND what would prove you wrong."

2. Baseline Validity

Check: Is the comparison group / baseline appropriate?

VerdictCriteria
PASSBaseline accounts for seasonality, concurrent changes, and selection effects
WARNINGBaseline is reasonable but has known gaps (e.g., no YoY comparison available)
FAILBaseline is naive (e.g., "compare to last week" without checking for holidays, campaigns, or deployments)

Common traps to check:

  • Comparing to a period with a holiday, major campaign, or outage
  • Before/after with no control group
  • Comparing cohorts of different sizes or compositions
  • Using "last month" when the metric is seasonal

Fix if FAIL: "Identify 2-3 alternative baselines and explain why each is valid or invalid."

3. Survivorship Bias

Check: Does the analysis only look at entities that "survived" to be measured?

VerdictCriteria
PASSAnalysis includes churned/dropped users, failed transactions, abandoned sessions
WARNINGSurvivorship risk is acknowledged but not controlled for
FAILAnalysis only includes "active" or "completed" entities without acknowledging what's excluded

Common traps:

  • "Average revenue per user" that only counts users who made a purchase
  • "Onboarding completion rate" that only counts users who started onboarding
  • "Feature satisfaction" survey that only reaches users who didn't churn
  • Retention analysis that excludes users who churned before the measurement window

Fix if FAIL: "Explicitly define the denominator. Who is EXCLUDED from this analysis and why?"

4. Segment Coverage

Check: Will the analysis check for segment-level differences that could reverse the overall finding?

VerdictCriteria
PASSPlan includes segment breakdowns on 3+ dimensions with explicit Simpson's paradox check
WARNINGPlan checks 1-2 segments but doesn't systematically test all categorical dimensions
FAILPlan only reports overall/aggregate numbers

Key segments to always check:

  • Device (mobile/desktop/tablet)
  • Platform (iOS/Android/web)
  • User tenure (new/returning/power user)
  • Geography (if multi-market)
  • Traffic source / acquisition channel
  • Product category / feature area
  • Customer tier / plan type

Fix if FAIL: "Add segment breakdowns for every categorical dimension with >2 values. Flag any reversal."

Show full SKILL.md (579 more words)Show less
5. Confound Identification

Check: Does the plan identify and control for concurrent changes?

VerdictCriteria
PASSPlan lists all known concurrent changes and has a control strategy for each
WARNINGPlan acknowledges confounds exist but doesn't have a strategy to isolate them
FAILPlan doesn't mention confounds or assumes the hypothesized cause is the only thing that changed

Questions to surface confounds:

  • What else shipped/launched/changed in the same time period?
  • Were there any data pipeline or tracking changes?
  • Did marketing spend or campaign strategy shift?
  • Were there external events (holidays, competitor moves, news)?
  • Did the user population change (growth spike, new channel, geography expansion)?

Fix if FAIL: "List every change that happened in the same time window. For each, explain how you'll separate its effect."

6. Kill Criteria

Check: Does the plan define what would make you REJECT the hypothesis?

VerdictCriteria
PASSExplicit thresholds for acceptance AND rejection, plus practical significance criteria
WARNINGHas acceptance criteria but no rejection criteria (can only "confirm," never "disprove")
FAILNo criteria — "we'll see what the data shows"

What good criteria look like:

  • "If the effect is less than 2pp, it's not practically significant regardless of p-value"
  • "If the drop is uniform across all segments, the widget hypothesis is rejected"
  • "If the confound analysis shows the loyalty program explains >60% of the variance, the widget is not the primary cause"

Fix if FAIL: "Define the minimum effect size that matters AND what finding would disprove your hypothesis."

7. Output Alignment

Check: Will the analysis output actually answer the stakeholder's question? AND can the analysis be executed with available data?

VerdictCriteria
PASSOutput format matches stakeholder need AND all required data exists
WARNINGOutput will be useful but may need translation for the audience, OR data exists but may have quality/completeness issues
FAILOutput is descriptive ("here's what happened") when stakeholder needs prescriptive ("here's what to do"), OR BLOCKER: required data does not exist (e.g., plan requires "product category" but dataset has no category field)

Common misalignment:

  • Stakeholder wants a recommendation, plan produces a description
  • Stakeholder wants dollar impact, plan produces percentages
  • Stakeholder wants a yes/no, plan produces "it depends"
  • Stakeholder wants a 1-page brief, plan will produce a 20-page report
  • BLOCKER: Plan requires data fields that don't exist in the dataset

Fix if FAIL (data blocker): "HALT — this analysis cannot be executed. The dataset does not contain [required field]. Either locate the field in another table, request a data extension, or pivot to a different dimension that exists (e.g., analyze by customer segment instead of product category)."

Fix if FAIL (alignment): "Restate the stakeholder's actual question and work backwards to what the output must contain."


Output Format

Start with a 1-sentence executive summary at the top (before the separator line) stating the grade and any blockers.

STRESS TEST RESULTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[1-sentence summary: e.g., "GRADE D (2 FAILs, 2 WARNINGs) — significant redesign needed before execution" or "GRADE F — BLOCKER: required data does not exist"]

OVERALL GRADE: [A/B/C/D/F]

| # | Check | Verdict | Issue |
|---|-------|---------|-------|
| 1 | Hypothesis Clarity | PASS/WARNING/FAIL | ... |
| 2 | Baseline Validity | PASS/WARNING/FAIL | ... |
| 3 | Survivorship Bias | PASS/WARNING/FAIL | ... |
| 4 | Segment Coverage | PASS/WARNING/FAIL | ... |
| 5 | Confound Identification | PASS/WARNING/FAIL | ... |
| 6 | Kill Criteria | PASS/WARNING/FAIL | ... |
| 7 | Output Alignment | PASS/WARNING/FAIL | ... |

CRITICAL ISSUES (must fix before executing):
  - ... [If data blocker: "BLOCKER: Cannot execute — required data does not exist. [Field name] not found in dataset."]

WARNINGS (address if time allows):
  - ...

RECOMMENDED FIXES:
  1. ... [state what the fix eliminates, not a time estimate]
  2. ...
  3. ...
Grading Scale
GradeCriteria
A0 FAILs, 0-1 WARNINGs — execute with confidence
B0 FAILs, 2-3 WARNINGs — execute but address warnings
C1 FAIL, any WARNINGs — fix the failure before executing
D2 FAILs — significant redesign needed
F3+ FAILs — start over with the Analysis Design Brief

Output File

Saves to: working/stress_test_{{DATE}}.md


Examples

Review a plan you wrote
/stress-test "I'm going to compare this month's conversion rate to last month's, broken by device, to see if the new checkout flow helped."
Review a file
/stress-test working/investigation_plan_2026-03-28.md
With context
/stress-test working/analysis_brief.md context="Board meeting Friday, need to decide whether to invest $500K in onboarding redesign" audience="CEO and CFO"

Integration

  • Works independently of /analysis-design — use it on ANY plan
  • Can be chained: /analysis-design → /stress-test → fix → re-test
  • Complements the question-framing skill (which writes the Analysis Design Spec) by reviewing the plan after it's written
  • Pairs with Confound Scanner agent — the scanner finds threats proactively during planning; /stress-test reviews an existing plan retroactively

© ai-analyst-lab, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/stress-test of ai-analyst-lab/ai-analyst.

Open the folder on GitHubat commit 52c0744

Compare with similar skills

Stress Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Stress Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stress Test this skillai-analyst-lab/ai-analyst304—~2.9kAutomated safety check: PassMIT
Writing Livekit Scenarioslivekit-examples/agent-starter-python2641 repos~2.5kAutomated safety check: PassMIT
Go Testingcxuu/golang-skills1731 repos~1.3kAutomated safety check: PassApache-2.0
Goalcraftgrp06/goalcraft102—~3.8kAutomated safety check: PassMIT
Thinking Partnermattnowdev/thinking-partner206—~4.4kAutomated safety check: PassMIT
Visionkunchenguid/vision331—~2.9kAutomated safety check: PassMIT

Similar skills

  • Writing Livekit Scenarios

    livekit-examples/agent-starter-python

    Creates and maintains the scenarios a LiveKit agent simulation runs, and wires the agent to consume them.

    264 GitHub starsUsed in 1 repo~2.5k tokens
    Testing & QAAuto-check passed
  • Go Testing

    cxuu/golang-skills

    A skill your agent uses when writing, reviewing, or improving Go test code — including table-driven tests, subtests, parallel tests, test helpers, test doubles, and assertions with cmp.Diff.

    173 GitHub starsUsed in 1 repo~1.3k tokens
    Testing & QAAuto-check passed
  • Goalcraft

    grp06/goalcraft

    Turn a rough draft, vague ambition, or messy task brief into a powerful Codex /goal objective for persistent, evidence-checked work.

    102 GitHub stars~3.8k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Thinking Partner

    mattnowdev/thinking-partner

    A deterministic thinking partner that challenges assumptions and applies mental models to sharpen decisions, solve problems, and think more clearly.

    206 GitHub stars~4.4k tokensUpdated 6 mo ago
    Testing & QAAuto-check passed
  • Vision

    kunchenguid/vision

    Draft and stress-test a VISION.md for a repository, then iterate with the author on an interactive review board until approved.

    331 GitHub stars~2.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Volt Load Testing

    owenHochwald/volt

    Safely exercise and evaluate HTTP APIs with the Volt CLI, including authenticated requests, JSON bodies, staged load, machine-readable results, performance baselines, and before/after comparisons.

    141 GitHub stars~1.2k tokensUpdated 2 mo ago
    Testing & QAAuto-check passed

More from ai-analyst-lab/ai-analyst

All 43 skills in this repo
  • Always Compare

    ai-analyst-lab/ai-analyst

    Never present a metric or number in isolation; anchor every number to a comparison (prior period, benchmark, or another segment) or state that none is available.

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Archaeology

    ai-analyst-lab/ai-analyst

    Retrieve proven SQL patterns, table cheatsheets, and join patterns from .knowledge/query-archaeology/ so past work gets reused.

    304 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • Archive Analysis

    ai-analyst-lab/ai-analyst

    Save completed analyses to the knowledge system's analysis archive for future reference.

    304 GitHub stars~2.7k tokensUpdated 9 days ago
    Auto-check passed
  • Auth Preflight

    ai-analyst-lab/ai-analyst

    Verify Google Workspace MCP authentication at the start of any session that needs Google APIs (Docs, Slides, Drive).

    304 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • Causal

    ai-analyst-lab/ai-analyst

    Causal inference toolkit for when experiments are not possible: estimate treatment effects from observational data with assumption checks and mandatory caveats.

    304 GitHub stars~1.8k tokensUpdated 9 days ago
    Auto-check passed
  • Chart To Drive

    ai-analyst-lab/ai-analyst

    Standardized workflow for uploading local chart PNGs to Google Drive and making them available for insertion into Google Docs and Slides.

    304 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Stress Test

What does Stress Test do?

Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria. Stress Test is an agent skill from ai-analyst-lab/ai-analyst. Pressure-test any analysis plan or investigation design for methodological flaws before execution — wrong baselines, survivorship bias, missing segments, uncontrolled confounds, absent kill criteria.

When should I use Stress Test?

Stress Test fits situations like: tasks that involve Load testing.

How do I install Stress Test in Claude Code?

Run `npx skills add ai-analyst-lab/ai-analyst --skill stress-test -a claude-code`. Or copy the skill folder (.claude/skills/stress-test in ai-analyst-lab/ai-analyst) into .claude/skills/stress-test in your project. Claude Code loads it when a task matches its description.

How do I install Stress Test in Codex?

Run `npx skills add ai-analyst-lab/ai-analyst --skill stress-test -a codex`. Or copy the skill folder (.claude/skills/stress-test in ai-analyst-lab/ai-analyst) into .agents/skills/stress-test in your project. Codex loads it when a task matches its description.

Can I use Stress Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ai-analyst-lab/ai-analyst --skill stress-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stress-test, .gemini/skills/stress-test, .github/skills/stress-test and .opencode/skills/stress-test in your project.

What does Stress Test need to run?

SKILL.md names no scripts, command-line tools or credentials: Stress Test is instructions for the agent only.

Does Stress Test access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Stress Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Stress Test use?

Stress Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Stress Test use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Stress Test?

Skills that share tags, products or a category with Stress Test: Writing Livekit Scenarios (livekit-examples/agent-starter-python, 264 stars), Go Testing (cxuu/golang-skills, 173 stars), Goalcraft (grp06/goalcraft, 102 stars) and Thinking Partner (mattnowdev/thinking-partner, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stress Test?

ai-analyst-lab (a GitHub organization) maintains it in ai-analyst-lab/ai-analyst, which has 304 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 30, 2026.

Source: ai-analyst-lab/ai-analyst on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.