magnus919/agent-skills

qa-methodology

- Design and apply QA methodology for software teams: test strategy, regression testing, CI failure triage, test automation, quality gates and metrics, risk-based testing, exploratory testing, test design techniques, AI code quality gates (independent verif…

View source
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

QA Methodology

Senior-to-principal QA and SDET methodology: test strategy, automation, regression, risk-based prioritization, exploratory testing, quality gates, AI code quality gates for agentic Spec-Driven Development, agentic eval design, career leveling, and SDET engineering.

Ownership

You ownYou don't own
Test strategy — what to test, at what level, with what priorityRoot-cause debugging — route to systematic-debugging
Test automation — framework selection, parallelism, flaky managementSecurity implementation and threat modeling — route to secure-software-engineering
E2E automation strategy and coverage decisionsOperating a browser test tool (Playwright) — authoring/running specs, selectors, network mocking, scraping — route to playwright
Regression suites — selection, impact analysis, suite evolutionSpec pipeline mechanics and gate verdicts — route to spec-driven-development
Quality gates — blocking vs advisory, metrics, DORAEval framework governance and statistics — route to agent-evals-and-observability
Risk-based testing — P×I scoring, prioritization, registersVerification verdicts against explicit criteria — route to verification-methodology
Exploratory testing — SBTM charters, heuristics, toursFeature implementation — that's the developer
AI code quality gates — independent verification, AC testabilityProduction monitoring and incident response — that's SRE
Mutation-guided test hardening — bounded mutation review evidence and survivor triageVerification verdicts against explicit criteria — route to verification-methodology
Agentic eval design — dataset design, judge bias, flaky-eval discipline
QA career levels — Senior/Staff/Principal scope progression
SDET engineering — test infrastructure, gTAA, CI/CD integration

Core Principles

If it isn't tested, it's broken. Untested code is code whose failure mode hasn't been discovered yet.

Quality is a property of the process, not the artifact. Testing at the end doesn't create quality. Quality is designed in through strategy, automation, and gating throughout the cycle.

Test behavior, not implementation. Tests coupled to behavior survive refactoring; tests coupled to implementation break on it.

Risk drives priority. Not everything deserves equal test investment. Score probability × impact, then allocate accordingly.

Flaky tests are worse than no tests. A nondeterministic failure trains teams to ignore all failures. Quarantine on detection; rerun once, never twice.

Independent verification is non-negotiable. The implementing agent (or developer) must not self-verify. Separate session, fresh context, no shared priors.

Loading Guide

FileLoad when
references/test-strategy.mdDesigning a test strategy — pyramid shape, shift-left/right, cost-of-failure, coverage as diagnostic
references/test-automation.mdSelecting frameworks, parallelism/sharding, flaky quarantine, predictive ML test selection, mutation-guided hardening
references/quality-gates-and-metrics.mdDesigning quality gates (blocking vs advisory), DORA metrics, vanity-vs-actionable metrics, mutation testing
references/regression-testing.mdBuilding regression suites — impact analysis, selection math, suite evolution, shift-right feedback
references/test-data-management.mdTest data strategy — fixtures, factories, time-travel, masking, GDPR/PII rules
references/performance-testing.mdLoad/stress/soak testing — k6/Locust/Gatling/JMeter, SLO thresholds, CI cadence
references/security-testing.mdSecurity testing — OWASP Top 10:2025, STRIDE, SAST/DAST/SCA, supply chain/SBOM
references/ci-failure-triage.mdCI is red — exit-code taxonomy (1/2/126/127/137/139/143), git bisect, flake-vs-failure protocol
references/test-debugging.mdA test that should pass is failing — CI-vs-local divergence, ordering/shared state, mock binding
references/risk-based-testing.mdPrioritizing by risk — P×I formula, 5×5 matrix, risk workshop, register, reassessment triggers
references/exploratory-testing.mdExploratory testing — SBTM, charter writing, SFDIPOT/HICCUPPS heuristics, tours
references/test-design-techniques.mdChoosing test design techniques — EP, BVA, decision tables, state transition, pairwise, error guessing
references/qa-career-levels.mdQA career growth — Senior/Staff/Principal scope, leveling mechanics, archetypes, misconceptions
references/sdet-engineering.mdSDET role and skills — gTAA/TAF architecture, POM, SOLID for tests, build-vs-buy, testability
references/ai-code-quality-gates.mdReviewing AI-generated code — independent verification, AC testability, agent-test quality, human-in-the-loop
references/ai-test-artifact-evidence.mdProvenance, spec-first oracle review, generated-review triage, workflow evidence, and emergency exceptions for AI-assisted QA
references/agentic-eval-design.mdDesigning agent evals — dataset test design, judge bias, flaky-eval discipline, CI gate tiers, replay
templates/test-strategy.mdProducing a test strategy document — fill in scope, risk tiers, level allocation, automation targets
templates/risk-register.mdRecording risk assessment results — fill in items, P×I scores, owners, mitigations
templates/exploratory-charter.mdWriting an SBTM charter — fill in target, resources, discovery goal, timebox
templates/bug-report.mdFiling a structured bug report — fill in reproduction steps, expected vs actual, severity
templates/verification-plan.mdPlanning independent verification — fill in AC-to-method traceability, verifier assignment, exit criteria
templates/mutation-review.mdRecording bounded mutation review scope, classifications, survivor tests, and independent evidence
templates/ai-assisted-verification-note.mdRecording AI-assisted test/review provenance, independent oracle checks, and evidence disposition
assets/risk-matrix-grid.mdScoring risks during a workshop — 5×5 P×I grid with zone thresholds
assets/test-design-techniques-checklist.mdSelecting techniques for a feature — quick-reference checklist mapping scenario type to technique
assets/qa-definition-of-done.mdDefining release readiness — QA contribution to definition of done
scripts/risk-prioritize.pyComputing P×I rankings from a risk-items JSON file
scripts/check-ac-testability.pyChecking acceptance criteria for vague verbs and missing observable outcomes
evals/evals.jsonRunning output-quality evals for this skill (schema v1, 15 cases)

Scripts

ScriptInvocationPurpose
risk-prioritizepython3 scripts/risk-prioritize.py --json <input.json>Reads risk items (probability, impact), computes P×I scores, emits ranked JSON
check-ac-testabilitypython3 scripts/check-ac-testability.py <spec.md>Scans acceptance criteria for untestable language, exits non-zero if any are flagged

Triggers

Load this skill when the task involves:

  • Test strategy — designing what/how/priority to test for a project or feature
  • Regression testing — building, selecting, or evolving regression suites
  • CI triage — diagnosing CI failures, exit codes, flake-vs-real classification
  • Test automation — framework selection, parallelism, flaky quarantine, ML selection
  • Quality gates — gate design, blocking vs advisory, metrics, DORA
  • Mutation-guided test hardening — diff-aware mutation scope, surviving mutants, weak assertions, and review evidence
  • Risk-based testing — P×I scoring, risk registers, prioritization workshops
  • Exploratory testing — SBTM charters, oracle heuristics, session debriefs
  • Agentic evals — eval dataset design, judge bias, flaky-eval discipline, CI tiers
  • SDD gate review — QA ownership at spec-driven gates, AC testability, independent verification
  • SDET — test infrastructure engineering, gTAA, CI/CD integration, career scope

When not to use

Route to the named sibling skill instead:

  • spec-driven-development — writing specs, running the SDD pipeline, gate verdict format, revision loops
  • agent-evals-and-observability — eval framework governance, statistical comparisons, telemetry and privacy controls, grader implementation
  • verification-methodology — collecting evidence and rendering verdicts against explicit pass/fail criteria
  • release-engineering — composing test evidence into release-candidate readiness, promotion, go/no-go, production rollout, and rollback decisions; QA owns test strategy and gate semantics
  • systematic-debugging — root-cause analysis of production incidents, bug reproduction, fault localization
  • secure-software-engineering — security implementation, threat modeling, secure defaults, dependency evaluation
  • playwright — operating the Playwright tool itself: authoring and running E2E specs, selector robustness, network mocking, headless scraping, and headed debugging

Stop and Exit Conditions

  • Test strategy complete when: strategy document names risk tiers, level allocation, automation targets, and exit criteria for each tier.
  • Risk assessment complete when: every identified risk has a P×I score, an owner, and a mitigation or acceptance decision recorded in the register.
  • CI triage complete when: failure is classified (flake vs real, env vs code), root cause is localized, and a fix or escalation path is identified.
  • Gate review complete when: every acceptance criterion maps to a verification method, the verifier is independent of the implementer, and evidence is attached.
  • Bounded escalation: stop after three non-converging diagnostic passes and report the evidence collected so far.
from this repository

More skills

All skills
magnus919
Community

frontend-engineering

Build and maintain web frontends — component architecture, state management, API integration, responsive layout, client-side performance, and frontend testing patterns. Framework agnostic, focused on web frontend implementation. Do not use for backend service implementation, data engineering, or platform infrastructure work.

installs
1
GitHub stars
87
Updated
Sep 20
magnus919
Community

systematic-debugging

- Diagnose root causes with a four-phase debugging protocol. Use for ANY technical issue — test failures, production bugs, unexpected behavior, performance problems, build failures, or integration issues. ESPECIALLY when under time pressure, when "one quick fix" seems obvious, or when previous fix attempts have failed. Do not use this skill for unrelated requests; route to the nearest named specialist.

installs
1
GitHub stars
87
Updated
Sep 20
magnus919
Community

api-design-and-evolution

- Design, govern, document, review, and evolve consumer-facing APIs and event interfaces. Use when choosing REST/HTTP, GraphQL, RPC, events, webhooks, or streaming; writing OpenAPI or AsyncAPI contracts; assessing an API landscape, ownership, duplication, lifecycle, discoverability, retirement, gateways, service meshes, north-south or east-west traffic, routing, policy, observability, or failure boundaries; defining schemas, pagination, mutations, errors, idempotency, or compatibility; or planning versioning, deprecation, and migration. Do not use for product discovery, platform operations, full security assessment, ADR authoring, or delivery gates; route those to the neighboring specialist skills.

installs
1
GitHub stars
85
Updated
Sep 18
magnus919
Community

release-engineering

- Design, automate, and operate end-to-end software releases: release process models and pipelines (trunk-based development, CD stages, release trains), progressive delivery and feature flags, versioning and artifact management (SemVer, conventional commits, changelogs, SBOM/provenance), readiness and quality gates, rollback and recovery planning, change-management and audit compliance (SOC 2, SOX, PCI), DORA metrics, and multi-team release coordination. Do not use for application feature implementation (backend-engineering/frontend-engineering), production incident root-cause debugging or on-call/SLO operations (systematic-debugging / site-reliability-engineering), security implementation or threat modeling (secure-software-engineering), or internal developer platform construction (platform-engineering).

installs
1
GitHub stars
78
Updated
Sep 10