debugging-experiments — Claude Code skill: setup and features
debugging-experiments — a Claude Code skill for investigating PostHog experiment results. It checks uneven or missing exposures against the experiment’s data and known causes.
no license 150 installs ★ 101 updated 2026-10-24
npx skills add PostHog/ai-plugin --skill debugging-experiments -a claude-codeWhat debugging-experiments does
The skill investigates support questions about PostHog A/B test results, including uneven exposures, a variant with no traffic, bias warnings, and numbers that differ from SQL. It reads the experiment data, identifies a likely cause, then drafts an explanation with a fix and supporting figures.
For deeper checks, it loads the diagnosing-experiment-health library. It matches the proposed fix to the experiment’s state, whether draft, running, or stopped. This skill is not for creating experiments, configuring rollout or metrics, lifecycle questions, or debugging a misbehaving feature flag.
What it helps with
- trace an uneven exposure split to its cause
- find out why a variant receives no traffic
- investigate missing or unusually low exposure counts
- compare PostHog experiment results with SQL
- explain a bias warning and outline a fix
Example prompts for the agent
- Investigate why the variants in this experiment have different exposure counts.
- One variant has no traffic. Check the data and explain what is happening.
- Compare this PostHog experiment with my SQL results and find the discrepancy.
How to install debugging-experiments
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-experiments -a claude-code2Manually: put the files in place
~/.claude/skills/debugging-experiments/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/debugging-experiments/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-experiments -a codex2Manually: put the files in place
.agents/skills/debugging-experiments/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-experiments -a cursor2Manually: put the files in place
.cursor/skills/debugging-experiments/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/debugging-experiments2Manually: put the files in place
.github/skills/debugging-experiments/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-experiments -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/debugging-experimentsManually: put the files in place
.devin/skills/debugging-experiments/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill debugging-experiments -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about debugging-experiments
How do I install debugging-experiments in Claude Code?
Run npx skills add PostHog/ai-plugin --skill debugging-experiments -a claude-code. The skill file is at ~/.claude/skills/debugging-experiments/SKILL.md.
What does debugging-experiments do?
It reads PostHog experiment data to investigate result issues, finds a likely cause, and prepares an explanation with a fix and figures that support it.
What kinds of questions trigger debugging-experiments?
Questions about experiment results, such as uneven exposures, a variant receiving no traffic, or a mismatch with SQL. It is not intended for experiment creation or rollout configuration.