# improving-test-suites

improving-test-suites is a Claude Code skill that reviews test suites and focuses them on important behavior. It activates for requests to trim, rewrite, review, or strengthen tests.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 119 installs · ★ 3 repo stars
- Author: b-mendoza
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/improving-test-suites/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/improving-test-suites

## What it does

The skill examines the specified test files and proposes a compact set of behavior checks. Subagents handle scoped review tasks and return short reports; the orchestrator turns them into an itemized change plan. Test changes require approval unless `AUTO_APPROVE=true` bypasses the plan-approval request.

After approved edits, it checks that each retained high-value behavior still has a named test, then runs validation. Repair is capped at three attempts. Set `TARGET_TEST_FILES` to identify the suite; `TEST_COMMAND` can provide the command used to run it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill improving-test-suites -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/improving-test-suites/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/improving-test-suites/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill improving-test-suites -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/improving-test-suites/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill improving-test-suites -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/improving-test-suites/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b-mendoza/agent-skills skills/improving-test-suites
```

2. **Manually: put the files in place**
- File: `.github/skills/improving-test-suites/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill improving-test-suites -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/improving-test-suites
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/improving-test-suites/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill improving-test-suites -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/improving-test-suites/SKILL.md

## When to use it
- trim tests that duplicate low-value implementation details
- spot brittle checks tied to internal code structure
- review coverage for contracts, schemas, or security behavior
- verify important cases remain covered after test edits

## Example prompts
- Review `tests/test_billing.py` and keep tests for important behavior.
- Trim brittle tests under `tests/api/` without editing application files.
- Review the schema and authorization tests, then propose a change plan.

## Similar
- [test-audit](https://affpapa.org/en/nevibecode/plugins/test-audit.md) — plugin · ★ 1216 repo stars
- [test-automation-framework](https://affpapa.org/en/nevibecode/skills/test-automation-framework.md) — skill · 507 installs
- [test-writer](https://affpapa.org/en/nevibecode/skills/vstorm-co-test-writer.md) — skill · ★ 1125 repo stars
- [test-smell-detection](https://affpapa.org/en/nevibecode/skills/test-smell-detection.md) — skill · 4400 installs
- [test-guard](https://affpapa.org/en/nevibecode/skills/test-guard.md) — skill · 4400 installs
- [test-quality-analysis](https://affpapa.org/en/nevibecode/skills/test-quality-analysis.md) — skill · 478 installs

From the same set: [b-mendoza/agent-skills](https://affpapa.org/en/nevibecode/by/b-mendoza/agent-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
