Terminal
Terminal/Skill
Turns on test impact analysis, dynamic test splitting and auto-rerun for an existing CircleCI testsuite (a paid plan or beta may apply).
By CircleCI
Works with
npx skills add circleci-public/skills --skill circleci-smarter-testingThese features may require a paid plan or be in beta — verify current availability and pricing before promising them to the user.
Builds on top of testsuite. Ask the user which of these they want (don't assume all three):
Start with:
circleci testsuite doctor "<suite name>" --json
If .circleci/test-suites.yml doesn't exist, or checks don't all pass, stop and send the user to circleci-testsuite first — never enable these options against a suite that isn't doctor-clean.
Set options: store-test-results: true alongside whichever features the user enables, if it isn't already set — it's a separate recommended setting, required for some feature to work. It replaces any classic store_test_results job step. Rerun doctor to confirm.
For each feature the user wants:
options: snippet from doctor's next_steps (test-impact-analysis: true, dynamic-test-splitting: true, max-auto-rerun: <0-10>).file-mapper when atoms aren't files, missing job parallelism for splitting) and repeat until clean.testsuite run during setup:
circleci testsuite run "<suite name>" --analyze-tests=impacted
Once test impact analysis is enabled and seeded, recommend the user replace their everyday local test command (npm test, pytest, go test, etc.) with circleci testsuite run "<suite name>" --local — it uses locally stored impact data, so local runs select only the tests impacted by uncommitted changes, same as CI.
circleci testsuite doctor "<suite name>" is the only command that executes tests during setup, except the one-time seed step and the --local dev-loop recommendation above.test-suites.yml — use contexts/env vars. Don't commit local impact data under .circleci/.circleci-cli, other config/caching/workspace work to circleci-config, and CI failures after a doctor-clean config to circleci-builds.Remove extraneous files created during setup. Report which features were enabled, files changed, the final doctor output, and any blocked prerequisites.