About run-smoke-tests
run-smoke-tests is a skill for end-to-end smoke verification before or after changes. It guides preparation, test execution, failure investigation, minimal fixes, and reruns, with safeguards against flaky tests.
Key features
- 01Builds target app prerequisites
- 02Runs full or focused smoke tests
- 03Investigates traces and logs on failure
- 04Applies minimal fixes and reruns tests
- 05Reduces flaky results with test guardrails
Use cases
- 01Verifying an app after changes
- 02Running one smoke test file
- 03Diagnosing a smoke test failure
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/run-smoke-testsin Claude Code to confirm it loaded.
Details
From the project READMERun smoke tests
Trigger
Need end-to-end smoke verification before or after changes.
Workflow
- Build prerequisites for the target app.
- Run the relevant smoke suite or a focused test file.
- If failing, inspect traces/logs and isolate the root cause.
- Apply a minimal fix and rerun until stable.
Example Commands
# Run full smoke suite
npm run smoketest
# Run a specific smoke test file
npm run smoketest -- path/to/test.spec.ts
# Faster iteration when build artifacts are ready
npm run smoketest-no-compile -- path/to/test.spec.ts
Guardrails
- Prefer deterministic waits and assertions over brittle timeouts.
- Re-run passing fixes to reduce flaky false positives.
- Quarantine tests only when explicitly requested and documented.
Output
- Test results summary
- Root cause and fix
- Remaining flake risk (if any)
Comments
Markdown supported