# QA Reviewer

> Runs a structured multi-phase verification pass on completed AI agent work — catching bugs, missed requirements, and incorrect assumptions before changes are committed. Triggers on: "check your work", "review this", after complex multi-step implementations, before committing major refactors, or proactively after any task longer than five steps.

- Skill: `shipshitdev/qa-reviewer` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add shipshitdev/qa-reviewer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shipshitdev/qa-reviewer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: shipshitdev (https://skillmd.com/u/shipshitdev)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/shipshitdev/qa-reviewer

---


# QA Reviewer: Systematic Work Verification

## Purpose

Structured framework for reviewing AI agent work before finalizing changes. Catches bugs, verifies accuracy, ensures completeness, validates solutions match requirements.

## When to Use

- User says "check your work" or "review this"
- After completing complex multi-step implementations
- Before committing major refactors
- When modifying commands or skills
- After implementing new features
- Proactively after any task >5 steps

## QA Workflow Phases

### 1. Context Gathering

- Review original task and requirements
- List all deliverables (files created/modified/deleted)
- Check critical rules in the applicable `AGENTS.override.md` / `AGENTS.md`
  chain and explicitly configured fallback files; include `CLAUDE.md` for
  Claude-specific rules

### 2. Requirement Verification

- Create checklist of all requirements
- Verify solution alignment
- Check for edge cases

### 3. Accuracy Verification

- Verify file paths exist
- Confirm patterns match codebase
- Cross-reference citations

### 4. Bug Detection

- Check syntax (markdown, code, paths)
- Look for logic errors
- Verify project-specific rules

### 5. Completeness Audit

- Reconcile todo list
- Verify all mentioned files changed
- Check for side effects

### 6. Optimization Review

- Evaluate solution quality
- Check pattern consistency
- Consider alternatives

## Quick Verification Commands

```bash
# Verify file exists
ls -la <file-path>

# Check balanced code blocks
grep -c '```' file.md

# Find violations
grep -r "console\.log" <files>
grep -r ": any" <files>
```

## Project Rules Check

- [ ] No console.log (use logger)
- [ ] No `any` types
- [ ] No inline interfaces
- [ ] Applicable AGENTS files intact and scoped overrides intentional
- [ ] Configured fallback instruction files exist and are nonempty
- [ ] .agents/ folders untouched
- [ ] Multi-tenancy preserved

## Final Assessment Categories

- **Approve** - Ready to commit
- **Conditional** - Fix issues first
- **Reject** - Significant problems

---

For complete workflow phases, output format template, common issue patterns, and advanced techniques, load `${CLAUDE_SKILL_DIR}/references/full-guide.md` when performing a comprehensive QA pass or when the task has more than three deliverables.