test-skills

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 11 Open GitHub ↗

Playwright E2E testing skills for AI coding agents (Claude Code, Codex, Cursor, Antigravity)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/agentmantis/test-skills/main/LICENSE)
[![Skills](https://img.shields.io/badge/skills-6-green.svg)](https://raw.githubusercontent.com/agentmantis/test-skills/main/)
[![Agents](https://img.shields.io/badge/agents-40+-orange.svg)](https://raw.githubusercontent.com/agentmantis/test-skills/main/)
[![Agent Skills](https://img.shields.io/badge/agent--skills-compatible-brightgreen.svg)](https://agentskills.io)

# TestSkills

> Agent skills that turn AI coding assistants into senior-level SDETs — writing production-grade Playwright E2E tests, scaffolding projects, generating Page Object Models, and managing the full test lifecycle from handover through regression.

Install once, and your agent knows how to structure, write, and maintain end-to-end tests the way a senior SDET would. Skills follow the open [Agent Skills](https://agentskills.io) standard and work with 40+ AI coding agents.

Fix the QA bottleneck AI created.

## Why this exists

AI agents can generate code, open PRs, and accelerate delivery —
but they still struggle to create and maintain reliable end-to-end tests.

This leaves QA as the bottleneck.

TestSkills bridges that gap by teaching agents how to:
- structure test suites correctly
- write stable Playwright tests
- manage the lifecycle from handover → regression

So speed doesn't come at the cost of confidence.

## Quick Start

```bash
npx skills add AgentMantis/test-skills
```

Or install for a specific agent:

```bash
npx skills add AgentMantis/test-skills --agent claude-code
npx skills add AgentMantis/test-skills --agent cursor
npx skills add AgentMantis/test-skills --skill create-pom   # single skill only
```

Then ask your agent:

```
> Set up an e2e test suite for my project
> Create a page object for the login page
> Write a regression test for the vault feature
> Write a handover test for MANT-456
> Promote the MANT-456 test to regression
```

In Claude Code, skills also register as slash commands: `/e2e-test-suite-init`, `/create-pom`, `/create-regression-test`, `/create-handover-test`, `/promote-handover-test`.

## Before vs After

Without TestSkills:
- inconsistent test structure
- brittle Playwright tests
- unclear promotion from handover → regression
- QA bottlenecks as AI accelerates delivery

With TestSkills:
- standardised test architecture
- repeatable Page Object Models
- lifecycle-driven testing (handover → regression)
- agents that behave like senior SDETs

## Skills

| Skill | Type | Invoke | Description |
|-------|------|--------|-------------|
| `e2e-test-conventions` | Reference | _auto-loaded_ | Core conventions — project structure, naming, selectors, auth, parallelism, environment config |
| `e2e-test-suite-init` | Task | `/e2e-test-suite-init [name]` | Scaffolds a complete `e2e/` directory with config, base classes, fixtures, and helpers |
| `create-pom` | Task | `/create-pom [page]` | Creates a Page Object Model with lifecycle methods, locators, JSDoc, and comment banners |
| `create-regression-test` | Task | `/create-regression-test [feature]` | Scaffolds a regression or smoke spec with test data JSON, fixtures, and beforeAll cleanup |
| `create-handover-test` | Task | `/create-handover-test [TICKET] [desc]` | Creates a ticket-driven handover test with proper naming and promotion lifecycle |
| `promote-handover-test` | Task | `/promote-handover-test [TICKET]` | Promotes a handover test to the regression or smoke suite |

Each skill is **self-contained** and can be installed independently with `--skill <name>`. The `e2e-test-conventions` reference skill is loaded automatically whenever any task skill runs.

### Workflow

Skills are designed to be used in sequence as your project grows:

```
e2e-test-conventions (auto-loaded — always active)
  → e2e-test-suite-init (run once per project)
    → create-pom (per page/view)
    → create-regression-test (per feature)
    → create-handover-test (per ticket)
      → promote-handover-test (when ticket is done)
```

## Opinionated by design

These skills enforce best practices used by senior SDETs.

They prioritise:
- stability over cleverness
- readability over abstraction
- lifecycle-driven testing over ad-hoc scripts

Because AI-generated tests are only useful if they can be trusted.

## Supported Agents

Skills follow the open [Agent Skills](https://agentskills.io) standard and work with **40+ AI coding agents** via `npx skills add`, including Claude Code, Codex, Cursor, Antigravity, GitHub Copilot, Augment, Gemini CLI, Windsurf, Roo, and more.

<details>
<summary>Installation options</summary>

### Recommended: `npx skills`

```bash
# Install all skills (auto-detects your agent)
npx skills add AgentMantis/test-skills

# Target a specific agent
npx skills add AgentMantis/test-skills --agent claude-code

# Install a single skill
npx skills add AgentMantis/test-skills --skill create-pom

# Install globally (available in all projects)
npx skills add AgentMantis/test-skills -g

# List available skills before installing
npx skills add AgentMantis/test-skills --list
```

### Manual Installation

```bash
cp -r skills/* ~/.claude/skills/      # Claude Code (personal)
cp -r skills/* .claude/skills/        # Claude Code (project)
```

</details>

<details>
<summary>Repository structure</summary>

```
test-skills/
├── skills/                          # Source of truth (edit here)
│   ├── e2e-test-conventions/        #   Reference skill (auto-loaded)
│   ├── e2e-test-suite-init/         #   Scaffold a new e2e/ directory
│   ├── create-pom/                  #   Generate a Page Object Model
│   ├── create-regression-test/      #   Generate a regression/smoke spec
│   ├── create-handover-test/        #   Generate a ticket-driven spec
│   └── promote-handover-test/       #   Promote handover → regression/smoke
├── docs/
│   └── CUSTOMIZATION.md             # Adapt skills to your project
├── CONTRIBUTING.md                  # How to add or modify skills
├── CHANGELOG.md                     # Release history
├── LICENSE                          # MIT
└── README.md
```

</details>

<details>
<summary>Customization</summary>

These skills teach **generic Playwright patterns** that work with any UI framework. To adapt them to your project's specific base classes, fixtures, folder structure, or auth flow, see **[docs/CUSTOMIZATION.md](docs/CUSTOMIZATION.md)**.

</details>

## Built by Agent Mantis

TestSkills is part of the Agent Mantis ecosystem —
a Testing-as-a-Service platform designed for AI-native development teams.

If you're using AI to ship faster, Agent Mantis helps you:
- validate changes continuously
- orchestrate testing workflows
- maintain confidence at scale

→ Learn more: https://agentmantis.com

## Architecture: Source of truth

The `skills/` directory is the **single source of truth** for all skill content.

**Only edit files inside `skills/`.** Do not create or modify files outside this directory for skill content. Each skill lives in its own subdirectory with a `SKILL.md` and optional `references/` folder — this is the standard format that `npx skills add` distributes to all agents.

## Contributing

We welcome contributions — new skills, bug fixes, and improvements to existing skills. See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on the SKILL.md format, testing expectations, and how to submit a PR.

## License

test-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README