# Agent Tests

> Agent-runnable e2e tests that validate workflows with real commands

- Skill: `yurifrl/agent-tests` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yurifrl/agent-tests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yurifrl/agent-tests/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yurifrl (https://skillmd.com/u/yurifrl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yurifrl/agent-tests

---


# Agent Tests

End-to-end tests that an agent (or human) can execute using real CLI calls. No mocking — run real commands, observe real outcomes, assert expected state.

## Location

```
.agents/tests/<test-name>/
├── TEST.md          # Required: test definition
├── test-*.sh        # Optional: executable test script
└── fixtures/        # Optional: test data
```

## TEST.md Format

```markdown
# Test: <Name>

## Context
[What this test validates and why]

## Workflow
1. [Step with real command]
2. [Step with real command]
3. ...

## Assertions

| Step | What to check | How |
|------|--------------|-----|
| ... | ... | `command to verify` |

## Commands
[Optional: bash script or inline commands that run the full test]

## Cleanup
[How to undo side effects, flags like --no-cleanup]
```

## Guidelines

- Tests use real tools (gh, kubectl, curl, etc.) — no mocks
- Each test is self-contained in its directory
- TEST.md is the source of truth, scripts are optional automation
- Include cleanup steps or --no-cleanup flag for inspection
- Use polling with timeouts for async workflows
- Print step-by-step progress when scripted
- Tests can accept arguments (target repo, environment, flags)