Web App Smoke Test Plan skill for Claude and Codex

Web App Smoke Test Plan as an AI skill. It asks for App and URL, Critical user paths, Roles and 3 more, then does the rest. Free to install in Claude or Codex.

Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.

Download the skill (.zip) · View SKILL.md

When it is used

Use when a web app needs a short browser smoke test covering its critical paths, data states, and roles, with screenshot evidence. Do not use for automated end-to-end test code or exhaustive regression testing. Related topics: coding, technical.

What it will ask you for

• App and URL (free text, e.g. "Name and address of the environment to test")
• Critical user paths (longer free text)
• Roles (choose any: Visitor, Signed-in user, Admin, Paying customer)
• Data states to cover (choose any: Empty, Few items, Many items, Error from server, Slow network)
• Devices (choose any: Desktop, Tablet, Phone)
• Time budget (number from 5 to 60)

How it works

1. Choose the critical paths whose failure would cost users or revenue and trim the list to fit the time budget.
2. Write numbered steps for each path with the exact expected result and a named screenshot as evidence.
3. Add one check per selected data state and role on the pages where it matters most.
4. Add a phone-width pass on the main path and a console check for errors on load.
5. Create a pass or fail log template and state which failures should block the release.

What you get

A table of paths with steps, expected results, and screenshot names, followed by a pass or fail log template and a release-blocking rule.

What it watches out for

• Testing only the happy path with a full account, and missing the empty state a new user sees first.
• Writing steps like check that it works with no expected result, so two testers can disagree.
• Planning more checks than the time budget allows, so the plan is skipped.

How to install

Claude.ai and the Claude desktop app

1. Download the skill .zip.
2. Open Settings, then Capabilities, and find Skills.
3. Choose Upload skill and select the .zip.
4. Ask Claude for help with the task. It loads the skill when your request matches.

Claude Code

1. Download the skill .zip.
2. Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
3. Start a new session. Claude Code loads the skill when your request matches.

Codex

1. Download the skill .zip.
2. Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
3. Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.

Cursor

1. Download the Cursor rule (.mdc).
2. Save it in .cursor/rules/ inside your project.
3. Cursor's agent applies the rule when your request matches its description.

AGENTS.md (Codex, Cursor, and other coding agents)

1. Copy the AGENTS.md section.
2. Paste it into AGENTS.md at the root of your repository, creating the file if needed.
3. Coding agents that read AGENTS.md follow it when your request fits.