Smoke Test Runner — Testing & QA agent for Claude Code
Runs the contract and hook test suites for a single plugin in the monorepo to validate plugin integrity after changes.
How to install Smoke Test Runner
Installs to ~/.claude/agents/gtapps-claude-code-hermit-smoke-test-runner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/gtapps/claude-code-hermit/HEAD/.claude/agents/smoke-test-runner.md -o ~/.claude/agents/gtapps-claude-code-hermit-smoke-test-runner.md Restart Claude Code, or start a new session, for it to be picked up.
What Smoke Test Runner does
name: smoke-test-runner description: Runs the contract and hook test suites for a single plugin in the monorepo to validate plugin integrity after changes. Takes a plugin slug. Use before releases or after significant modifications. model: sonnet effort: medium maxTurns: 10 tools:
- Read
- Bash
- Glob disallowedTools:
- Edit
- Write
- WebSearch
- WebFetch
You run a single plugin's test suites and report results. You do NOT fix anything — you report pass/fail.
Input cont
Alternatives in Testing & QA
- Claude Code Test Agent — Tests all 27 Claude Code hooks by logging each event to tests-agents-hook/agent-hook-fired.log 321 ★
- Provider Tester — Use this agent when you need to test, debug, or validate LLM provider configurations 175 ★
- Skill Creator — Generate spec-compliant skills for the cc-polymath library 131 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Genesis Engineer
The single engineer that owns the entire Genesis repo end to end: develops it via strict TDD + spec-driven dev
E2e Specs
E2E test agent that creates Playwright end-to-end tests from a plan's requirements. Tests drive the dashboard
Plugin Contract Reviewer
Verifies the otel-as-code repo conforms to Claude Code plugin runtime contracts — hook stdin payload keys and
Test Suite Analyzer
Detect one package's test suites for a Stop test hook - stack, runners, suite kind, hook command with fail-fas
Execution Agent
Autonomously executes a single subtask in its own worktree. Reads plan + subtask spec + declared context, impl
Mx Feature Builder
Use this agent to implement a single product feature from a spec. It takes one feature's specification (name,
Related Skills
Close Review
Month-end close / GL compliance check — invokes accounting-reviewer to produce TM-accounting-{slug}.md with do
Smoke
Verify structural integrity of the harness surface. Fast, no external tools needed.
Validate Test Suite
Validate Test Suites