AI Agent Skills

ZeniTest provides a dedicated Agent Skill so AI coding assistants (Claude Code, OpenAI Codex, Cursor, Antigravity, etc.) can automatically generate, run, and maintain test cases as your application evolves.

---

Installing the Skill

Option 1: Automatic Installation (Recommended)

Run the skill installer using your package manager in your project root:

npm

npx skills add zeni-org/zenitest

pnpm

pnpm dlx skills add zeni-org/zenitest

yarn

yarn dlx skills add zeni-org/zenitest

bun

bunx skills add zeni-org/zenitest

This installs the zenitest skill configuration into your project’s .agents/skills/ directory.

---

Option 2: Manual Installation

Create .agents/skills/zenitest/SKILL.md (or .claude/skills/zenitest/SKILL.md / .cursor/skills/zenitest/SKILL.md) in your project:

mkdir -p .agents/skills/zenitest

Add the following content to .agents/skills/zenitest/SKILL.md:

---
name: zenitest
description: Instructions for generating and maintaining ZeniTest YAML test cases and running the zenitest CLI.
---

# ZeniTest Agent Skill Guide

## 1. Test Case YAML Format

Save test files in `zeni_tests/*.yaml`.

### Required Fields
- `id`: Unique identifier (e.g. `tc_login_001`)
- `title`: Short scenario description
- `prodURL`: Target app URL (e.g. `https://app.example.com` or `http://localhost:3000`)
- `expectedResult`: Expected outcome description
- `steps`: Sequence of test actions (`navigate`, `act`, `validate`)

### Step Actions
- `- navigate: /path`
- `- act: Type '${username}' into 'Username'`
- `- act: Click 'Submit'`
- `- validate: Verify 'Dashboard' is displayed`

## 2. CLI Execution

To run tests:
```bash
zenitest run --dir zeni_tests
```

---

Using /zenitest Slash Commands

Once the skill is installed, simply type /zenitest followed by your prompt in your AI agent chat interface:

1. Generate New Test Cases

/zenitest Create an E2E test case for the new checkout page at /checkout

2. Update Existing Tests During Refactoring

/zenitest We updated the login button label from 'Login' to 'Sign In'. Please update our test suite in zeni_tests/

3. Run & Self-Heal Test Suites

/zenitest Run the test suite and fix any failing test scenarios