About run-smoke-tests
A coding skill for running end-to-end smoke tests before or after changes. It guides test selection, failure investigation, minimal fixes, and reruns to check stability.
Key features
- 01Build app prerequisites
- 02Run full or focused smoke tests
- 03Inspect traces and logs
- 04Apply minimal fixes and rerun
- 05Reduce flaky test results
Use cases
- 01Verify an app end to end
- 02Investigate smoke-test failures
- 03Check a fix with repeated runs
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