aws-test-plugin
AI agent skills for generating comprehensive tests for any AWS Python project — Lambda, API Gateway, Step Functions, and Batch.
Works with Claude Code, GitHub Copilot, and OpenAI Codex.
What It Does
Install this plugin into your AWS project, and your AI coding agent can:
- Discover all Lambdas, Batch jobs, Step Functions, and API specs in your repo
- Read handler code to understand branches, AWS calls, validation rules, error handling
- Generate tests covering every code path — not just happy-path templates
- Run & fix — execute tests, parse failures, fix root causes, re-run until green
Test Types
| Type | Tool | Needs Deploy? |
|---|
| Integration | moto + pytest | No |
| Contract | jsonschema + pytest | No |
| Performance | pytest-benchmark | No |
| E2E | requests + pytest | Yes |
| Load | Locust | Yes |
AWS Components Covered
| Component | Integration | E2E | Contract | Perf | Load |
|---|
| API Gateway + Lambda | ✓ | ✓ | ✓ | ✓ | ✓ |
| Step Functions | ✓ | ✓ | ✓ | ✓ | |
| Batch Jobs | ✓ | ✓ | | ✓ | |
| Lambda + DynamoDB | ✓ | | | ✓ | |
| Lambda + S3 | ✓ | | | | |
| Lambda + RDS/PostgreSQL | ✓ | | | | |
Installation
Option 1: Claude Code Plugin (recommended for Claude Code users)
This repo is a native Claude Code plugin. Install it directly:
# Test locally — load the plugin for one session
claude --plugin-dir /path/to/aws-test-plugin
After loading, skills are namespaced as /aws-test-plugin:aws-test-orchestrator, etc.
Use /reload-plugins to pick up changes during development.
Option 2: npx skills add
# Install skills into your project — auto-detects Claude Code, Copilot, Codex
npx skills add whitewhiteqq/aws-test-plugin
Flags:
npx skills add whitewhiteqq/aws-test-plugin --skill aws-e2e-testing # Single skill
npx skills add whitewhiteqq/aws-test-plugin --list # List skills
npx skills add whitewhiteqq/aws-test-plugin -a copilot # Copilot only
npx skills add whitewhiteqq/aws-test-plugin -g # Install globally
Option 3: uv (with CLI tools)
# Install the CLI tool globally (isolated venv, auto-managed by uv)
uv tool install git+https://github.com/whitewhiteqq/aws-test-plugin
# Then install skills into your project
cd your-aws-project
aws-test-plugin init .
Option 4: pip
pip install git+https://github.com/whitewhiteqq/aws-test-plugin
cd your-aws-project
aws-test-plugin init .
Option 5: Manual copy
git clone https://github.com/whitewhiteqq/aws-test-plugin.git
cd your-aws-project
# For Claude Code
cp -r aws-test-plugin/skills/* .claude/skills/
cp -r aws-test-plugin/agents/* .claude/agents/
# For GitHub Copilot
cp -r aws-test-plugin/skills/* .github/skills/
cp -r aws-test-plugin/agents/* .github/agents/
Install test dependencies
# All test deps at once
pip install "aws-test-plugin[all] @ git+https://github.com/whitewhiteqq/aws-test-plugin"
# Or just what you need
pip install "aws-test-plugin[test] @ git+https://github.com/whitewhiteqq/aws-test-plugin" # moto + pytest
pip install "aws-test-plugin[load] @ git+https://github.com/whitewhiteqq/aws-test-plugin" # Locust
pip install "aws-test-plugin[db] @ git+https://github.com/whitewhiteqq/aws-test-plugin" # testcontainers
pip install "aws-test-plugin[perf] @ git+https://github.com/whitewhiteqq/aws-test-plugin" # pytest-benchmark
CLI Commands
# Install skills for all agents (Claude Code + Copilot + Codex)
aws-test-plugin init .
# Install for specific agents only
aws-test-plugin init . --agent claude
aws-test-plugin init . --agent copilot
# List available skills
aws-test-plugin list
# Scaffold test directories (discovers Lambdas, creates conftest.py, pytest.ini)
aws-test-plugin scaffold .
What Gets Installed
Running aws-test-plugin init . creates:
your-project/
├── .claude/ # Claude Code
│ ├── skills/
│ │ ├── aws-test-orchestrator/ # Master skill: discover → delegate
│ │ ├── aws-e2e-testing/ # E2E patterns for API GW, SFN, Batch
│ │ ├── aws-integration-testing/ # moto patterns for S3, DDB, RDS
│ │ ├── aws-contract-testing/ # OpenAPI schema validation
│ │ └── aws-perf-load-testing/ # Benchmarks + Locust load tests
│ └── agents/
│ └── aws-test-engineer.md # Agent definition
├── .github/ # GitHub Copilot
│ ├── skills/ (same skills)
│ └── agents/ (same agent)
└── AGENTS.md # OpenAI Codex instructions
Usage
After installing, ask your AI agent:
whitewhiteqq