Agent skill
agent-tests
Agent-runnable e2e tests that validate workflows with real commands
Install this agent skill to your Project
npx add-skill https://github.com/yurifrl/cly/tree/main/.opencode/skill/agent-tests
SKILL.md
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
# 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)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ag:changelog
Generates and updates project CHANGELOG.md from git commits, conversation decisions, and architectural changes. Auto-invoke this skill when new features are added, features are removed, or architecture changes occur.
prompt-engineering
Prompt engineering reference and workflow for creating, refining, and reviewing high-quality prompts for AI tools, agents, and skills.
ag:claudemd-update
Updates CLAUDE.md based on recent conversation history. This skill should be used when the user asks to update their CLAUDE.md, sync learnings from conversations, or review what was discussed recently.
write-skill
Create Claude Code skills with proper structure and documentation. Use when building custom skills, writing SKILL.md files, or when user asks "write a skill" or "create Claude skill".
add-module
Create new demo or utility modules following CLY project patterns. Use when adding TUI demonstration modules to modules/demo/ or utility modules to modules/, following Bubbletea/Bubbles conventions with proper Cobra CLI integration.
git-worktrees
Manage git worktrees for parallel development. Use when user mentions worktrees, parallel branches, or working on multiple branches simultaneously.
Didn't find tool you were looking for?