mutation-testing · metabase — Claude Code skill: tests and setup
Runs mutation testing for a Clojure namespace, writes tests for surviving mutations, and opens draft PRs linked to Linear issues.
no license ★ 50,467 updated 2026-10-24
npx skills add metabase/metabase --skill mutation-testing -a claude-codeWhat mutation-testing does
This skill takes a Clojure namespace through mutation testing. It creates a baseline report, groups functions by coverage relationships, and calls claude -p to produce tests for mutations that remain alive. The workflow then checks the result, retries a group when needed, commits and pushes the changes.
Each processed group can produce a Linear issue and a draft pull request. Use --base-branch to select the base branch or --project-id to reuse an existing Linear project. The run requires a live nREPL connected to the Metabase development environment, LINEAR_API_KEY, an authenticated gh CLI, and claude on PATH. Those prerequisites are required before the workflow can run.
What it helps with
- run mutation testing against a Clojure namespace
- find mutations that current tests fail to kill
- generate tests for surviving mutations
- turn function groups into Linear issues and draft PRs
Example prompts for the agent
- Run
/mutation-testing metabase.lib.order-byand add tests for mutations that survive. - Test
metabase.lib.order-byagainst the base branchrelease-x.52.x. - Process
metabase.lib.order-byinside the existing Linear projectabc-123.
How to install mutation-testing
1Skills CLI (Vercel)
npx skills add metabase/metabase --skill mutation-testing -a claude-code2Manually: put the files in place
~/.claude/skills/mutation-testing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mutation-testing/
1Skills CLI (Vercel)
npx skills add metabase/metabase --skill mutation-testing -a codex2Manually: put the files in place
.agents/skills/mutation-testing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add metabase/metabase --skill mutation-testing -a cursor2Manually: put the files in place
.cursor/skills/mutation-testing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install metabase/metabase .claude/skills/mutation-testing2Manually: put the files in place
.github/skills/mutation-testing/SKILL.md1Skills CLI (Vercel)
npx skills add metabase/metabase --skill mutation-testing -a gemini-cli2Platform CLI
gemini skills install https://github.com/metabase/metabase --path .claude/skills/mutation-testingManually: put the files in place
.devin/skills/mutation-testing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add metabase/metabase --skill mutation-testing -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 mutation-testing
How do I install mutation-testing in Claude Code?
Run npx skills add metabase/metabase --skill mutation-testing -a claude-code. The skill is placed at ~/.claude/skills/mutation-testing/SKILL.md.
What does mutation-testing do?
It runs mutation testing for a Clojure namespace, creates tests for mutations that survive, and opens draft PRs with related Linear issues.
What does the skill require before it runs?
You need a live nREPL connected to the Metabase development environment, LINEAR_API_KEY, an authenticated gh CLI, and claude available on PATH. The first session also requires Linear team setup through list-teams! and set-config!.
Similar skills
All skills for Testing and QA →mutation-testing by other authors comes first.