test-automation

Plan, write, and review KATA-compliant Playwright and TypeScript automated tests.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/ahuaracab/test-genesis --skill test-automation-ahuaracab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-automation
Source: https://github.com/ahuaracab/test-genesis/tree/main/.agents/skills/test-automation
Command: npx skills add https://github.com/ahuaracab/test-genesis --skill test-automation-ahuaracab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing automated tests without a consistent architecture leads to duplicated components, flaky suites, and untraceable coverage. This Skill enforces the KATA (Komponent Action Test Architecture) pattern on Playwright + TypeScript projects through a mandatory Plan → Code → Review workflow, so every test is atomic, traceable to a TMS ticket, and passes type, lint, and execution gates before merge. ## Core Features & Use Cases - Structured Plan → Code → Review pipeline: Plans ATCs from acceptance criteria with anti-duplication checks against kata-manifest.json, codes components and test files via isolated subagents, then runs three parallel verifiers (test, typecheck, lint) as the merge gate. - KATA component architecture: Generates Api/Page components extending ApiBase/UiBase, registers them in fixtures, selects the correct fixture ({api}, {ui}, or {test}), and applies equivalence partitioning, BVA, and ATC atomicity rules. - Read-only explain mode: Explains existing automated tests and reports their assertions without entering the Plan-Code-Review workflow or editing any files. - Use Case: Given a Jira story with acceptance criteria, the Skill derives candidate ATCs, reuses existing components from the manifest, writes the integration or E2E test under tests/integration/{module}/ or tests/e2e/{module}/, and verifies it with bun run test, types:check, and lint:check before handing off to git workflows. ## Quick Start Ask the AI to automate the acceptance criteria of a specific Jira ticket into KATA-compliant Playwright tests using the test-automation skill.

Frequently Asked Questions about test-automation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write KATA-compliant Playwright tests with this skill?

Follow the mandatory Plan → Code → Review workflow: plan ATCs from acceptance criteria against kata-manifest.json, code components extending ApiBase or UiBase with the correct fixture, then pass three parallel verifiers running bun run test, types:check, and lint:check.

How do I choose between the api, ui, and test fixtures in Playwright?

Use {api} for API-only integration tests (no browser opens), {ui} for UI-only tests, and {test} for hybrid flows that set up data via API and drive the UI. Requesting {ui} for a test that never touches the UI wastes a browser launch.

What is the difference between an ATC and a helper in KATA architecture?

An ATC is a state-changing action decorated with @atc('TICKET-ID') that maps to a TMS test case and contains fixed assertions. A helper is a read-only method (like a simple GET) marked with @step and carries no ticket ID.

Can this skill explain existing automated tests without modifying them?

Yes, the explain mode (also triggered by the break-down-tests alias) loads only the explain-tests reference and produces a read-only report of assertions. It never creates session state, edits tests, or calls the TMS.

When should I not use this test automation skill?

Do not use it for running regression suites, documenting test cases in Jira/Xray, onboarding a new repository, or orchestrating sprint-wide testing. Those belong to the regression-testing, test-documentation, project-discovery, and sprint-testing skills respectively.

Why does the review phase reject tests that call other ATCs?

ATCs must be atomic mini-flows; one ATC calling another breaks traceability and the 1:1 TMS mapping. Reusable precondition chains repeated across 3+ files belong in a Steps class under tests/components/steps/, instantiated directly by the test.