QA Toolkit
A reusable, ISTQB-aligned QA toolkit for Web + REST API projects, packaged as a Claude Code plugin. Install it once, then drive your whole testing workflow with /qa:* slash commands in any repository. The only thing that changes between projects is a single config file: qa.config.yml.
Core stack the toolkit assumes (all configurable): Playwright + TypeScript for functional/E2E/API, K6 for performance, Pact for contract testing, axe for accessibility, OWASP ZAP / SCA / secret scanning for security, and Jenkins (or GitHub Actions / GitLab / Azure) for CI.
Standards compliance
The toolkit follows the ISTQB® framework strictly — Certified Tester Foundation Level (CTFL) v4.0, plus relevant Advanced/Agile/Specialist syllabi (Test Manager, Agile Tester, Test Automation Engineer, Performance, Security, Accessibility) — and the ISO/IEC/IEEE 29119-3 test-documentation standard. The commands implement the seven ISTQB test-process activities (planning, monitoring & control, analysis, design, implementation, execution, completion), use the seven testing principles as standing rules, apply ISTQB test design techniques (EP, BVA, decision tables, state transition, ATDD), and use ISTQB Glossary terminology throughout. Full traceability: docs/ISTQB-COMPLIANCE.md maps every command to its syllabus reference; docs/GLOSSARY.md defines the terms.
ISTQB syllabi and the Glossary are copyrighted by ISTQB. This toolkit implements their concepts and terminology; it does not reproduce the documents.
The idea in one picture
qa-toolkit (this repo, on GitHub) Your project A Your project B
┌──────────────────────────────┐ ┌───────────────┐ ┌───────────────┐
│ commands/ (64 /qa:* commands)│ install once │ qa.config.yml │ │ qa.config.yml │
│ skills/ (auto context) │ ─────────────► │ (the only │ ... │ (different │
│ templates/ (strategy & plan) │ via /plugin │ per-project │ │ values) │
└──────────────────────────────┘ │ file) │ │ │
identical everywhere └───────────────┘ └───────────────┘
Commands + templates are identical across every project. qa.config.yml supplies the project-specific values (stack, tooling toggles, CI platform, quality-gate thresholds, risk areas, team). Update one repo here → every project gets the improvement.
Install
# 1. Add this repo as a plugin marketplace (once per machine)
/plugin marketplace add qa-io-vn/qa.io.vn
# 2. Install the plugin
/plugin install qa@qa-toolkit
Replace qa-io-vn/qa.io.vn with your actual GitHub owner/repo. You can also point at a local path during development: /plugin marketplace add /path/to/qa-toolkit.
To update later: /plugin marketplace update qa-toolkit.
Use it on a project (first time)
cd your-project
# Generate the single per-project config interactively
/qa:qa-init
# Then build out your QA assets from that config
/qa:create-strategy # → docs/qa/TEST-STRATEGY.md
/qa:scaffold # → Playwright+TS / K6 / Pact framework + Jenkinsfile
/qa:create-plan R2.4 "guest checkout, saved cards" # → docs/qa/TEST-PLAN-R2.4.md
/qa:implement "guest checkout" # → E2E + API + contract tests for the feature
Everything reads qa.config.yml, so you never re-specify your stack or thresholds.
Commands (64)
A command for every ISTQB activity, so a tester can run the entire workflow through the agent. Grouped by the ISTQB test-process activity each implements. All commands read qa.config.yml, respect its tooling toggles, and use ISTQB Glossary terminology.
