Agent Skills

Smoketest Agent Skills teach coding agents like Codex and Claude Code how to find user tests in your local project and turn them into Smoketest tests.

Use them when you want an agent to inspect your repo, draft test files, and optionally create or update those tests through the Smoketest CLI after you review the plan.

Available skills

Both skills are draft-first:

• They write reviewable draft artifacts under .smoketest/.
• They check whether the Smoketest CLI is installed and signed in.
• They ask before creating or updating tests in Smoketest.
• They do not run tests unless you explicitly ask.
• They never ask you to paste secrets into chat; authenticated tests use Smoketest environments.
• Approved creates or updates applied through a CLI-signed-in profile count toward the dashboard start guide.

Quick start with Codex

Install the Smoketest plugin:

codex plugin marketplace add smoketest-sh/skills
codex plugin add smoketest@smoketest

Then ask Codex to use a skill:

Use $smoketest-explore to discover public user tests from this repo and https://staging.example.com.

Use $smoketest-changes to sync Smoketest test updates from this branch.

Quick start with Claude Code

Install the Smoketest plugin:

/plugin marketplace add smoketest-sh/skills
/plugin install smoketest@smoketest

Then run one of the skill commands:

/smoketest:smoketest-explore

/smoketest:smoketest-changes

CLI requirement

The skills use the Smoketest CLI for project lookup, existing-test checks, environments, and approved create/update operations.

If the CLI is not installed yet, run:

npm install --global @smoketest.sh/cli
smoketest auth login

Or start the guided setup:

npx @smoketest.sh/cli init

What the skills create

smoketest-explore writes drafts to:

.smoketest/explore/
  manifest.json
  tests/
  shared-steps/

smoketest-changes writes drafts to:

.smoketest/changes/
  manifest.json
  tests/
  shared-steps/

After you approve, the agent validates the manifest, previews the CLI changes, and applies creates or updates with the Smoketest CLI. The CLI marks those approved mutations with internal Agent Skill provenance headers, so Smoketest can distinguish applied work from local drafts without changing public API request bodies.

The resulting tests are available in the Smoketest web dashboard, where you can edit them, run them manually, configure schedules, and review run history with recordings.

Next steps