# run-smoke-tests

This skill runs Playwright smoke tests, digs into failures and confirms a fix holds. Handy before a release or after a risky change.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2100 installs · ★ 14099
- Author: cursor
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cursor/plugins/tree/HEAD/cursor-team-kit/skills/run-smoke-tests/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/run-smoke-tests

## What it does

The skill walks the agent through one path: build the app, run the smoke suite or a single spec, and on failure read traces and logs to pin down the cause. Then it applies the smallest fix and reruns until the result stops moving.

Three npm commands are baked in. `npm run smoketest` covers the whole suite, `npm run smoketest -- path/to/test.spec.ts` targets one file, and `npm run smoketest-no-compile -- path/to/test.spec.ts` skips the build step when artifacts already exist.

Your project has to define those npm scripts and have Playwright in place, otherwise the steps have nothing to call. The guardrails push deterministic waits and assertions over timeouts, ask for a rerun after a passing fix, and keep tests out of quarantine unless someone asks for it in writing. Expect a results summary, the root cause with its fix, and whatever flake risk is left.

## Requirements
- Works with: Playwright

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill run-smoke-tests -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill run-smoke-tests -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill run-smoke-tests -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cursor/plugins run-smoke-tests
```

2. **Manually: put the files in place**
- File: `.github/skills/run-smoke-tests/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill run-smoke-tests -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cursor/plugins --path cursor-team-kit/skills/run-smoke-tests
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill run-smoke-tests -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/cursor/plugins/tree/HEAD/cursor-team-kit/skills/run-smoke-tests/SKILL.md

## When to use it
- run a smoke suite before shipping a change
- test a single spec instead of the whole suite
- read a failing trace and locate the cause
- confirm a minimal fix actually cleared the failure
- tell a real bug apart from a flaky test

## Example prompts
- Run the smoke tests and show me what failed
- Run `npm run smoketest -- path/to/test.spec.ts` and debug the failure
- The fix is in — rerun the tests and check everything passes

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1200000 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs

From the same set: [cursor/plugins](https://affpapa.org/en/nevibecode/by/cursor/plugins.md) — 47 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