QA

QA

Diff-aware quality assurance. Analyzes git diffs, classifies file changes by category (style, component, API, data, config, test, docs, infra), and routes to the appropriate test/validation strategy. Smart QA — test what matters, skip what doesn't.

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/QA/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Voice Notification

When executing a workflow, do BOTH:

1. Send voice notification:

``bash curl -s -X POST http://localhost:8888/notify \ -H "Content-Type: application/json" \ -d '{"message": "Running the WORKFLOWNAME workflow in the QA skill to ACTION"}' \ > /dev/null 2>&1 & ``

1. Output text notification:

`` Running the **WorkflowName** workflow in the **QA** skill to ACTION... ``

Workflow Routing

| Workflow | Trigger | File | |----------|---------|------| | Analyze | "/qa", "what should I test", "check my changes", "diff analysis" | Workflows/Analyze.md | | QuickCheck | "quick check", "smoke test", "quick qa", "sanity check" | Workflows/QuickCheck.md |

Architecture

Two-stage process:

1. Script (Tools/DiffAnalyzer.ts) — deterministic diff parsing, file classification, route generation
2. AI orchestration — interpret routes, execute checks, report results

Tool Reference

Path: ~/.claude/skills/QA/Tools/DiffAnalyzer.ts

Usage:

# Diff against main (default)
bun ~/.claude/skills/QA/Tools/DiffAnalyzer.ts

# Diff against specific branch
bun ~/.claude/skills/QA/Tools/DiffAnalyzer.ts --branch develop

# Staged changes only
bun ~/.claude/skills/QA/Tools/DiffAnalyzer.ts --staged

# Explicit file list
bun ~/.claude/skills/QA/Tools/DiffAnalyzer.ts --files "src/api.ts,src/styles.css"

Output: JSON with file classifications, diff stats, and QA routing recommendations.

File Categories

| Category | Matches | QA Strategy | |----------|---------|-------------| | style | CSS, SCSS, Tailwind config | Visual regression — screenshot before/after | | component | TSX, JSX, Vue, Svelte | Component render check — verify UI | | api | Route handlers, controllers, middleware | Endpoint validation — test request/response | | data | Migrations, schemas, seeds, Prisma | Migration safety — check destructive ops | | config | JSON, YAML, TOML, env files | Config validation — syntax and required fields | | test | .test., .spec., __tests__ | Test-only — run modified tests | | docs | Markdown, README, CHANGELOG | Documentation review — link and accuracy check | | infra | Dockerfile, CI/CD, deploy configs | Infrastructure review — verify deploy config |

Diff Size Routing

| Size | Lines Changed | Strategy | |------|--------------|----------| | Small | <50 | Quick smoke test — focused verification | | Medium | 50-199 | Standard testing — run related tests | | Large | 200+ | Full suite — comprehensive check recommended |

Examples

Example 1: Before shipping a feature

User: "/qa"
→ Runs DiffAnalyzer.ts against main
→ "12 files changed: 3 component, 2 api, 1 style, 6 test"
→ Routes: visual check for style, endpoint validation for API, run component tests
→ Executes each route, reports results

Example 2: Quick sanity check

User: "quick check"
→ Runs DiffAnalyzer.ts --staged
→ "2 files changed: 1 config, 1 api (small diff)"
→ Quick smoke test: validate config syntax, curl API endpoint

Example 3: Explicit files

User: "qa these files: src/auth.ts, src/auth.test.ts"
→ Runs DiffAnalyzer.ts --files "src/auth.ts,src/auth.test.ts"
→ Routes: API validation for auth.ts, run auth.test.ts

Integration

• Ship skill: Run /qa before /ship to verify changes
• Evals: QA routes map to Evals grader types (codebased for config, llmrubric for docs)
• Browser: Visual regression checks use Browser skill for screenshots

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: phuaky
• Source: phuaky/pai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.