# petrkindlmann/qa-skills architecture

> Architecture diagram of the GitHub repository petrkindlmann/qa-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/petrkindlmann/qa-skills
- Repository: https://github.com/petrkindlmann/qa-skills

## Overview

QA Skills for AI Agents is a curated library of 50 agent-readable QA and test-automation skills, not a running test platform. A user asks an AI agent for QA help; the agent selects and applies relevant skill guidance, then returns a plan, tests, analysis, or setup advice. The graph groups documented capabilities by domain and includes the project-context foundation. README and the sampled files support the product workflow; individual skill content was not sampled, so internal skill-to-skill wiring is not inferred.

Main entry points: [`skills/qa-project-context`](https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-context) (Project Context), [`skills/qa-project-bootstrap`](https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-bootstrap) (QA Bootstrap), [`skills/test-strategy`](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-strategy) (Test Strategy), [`skills/test-planning`](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-planning) (Test Planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation_strategy["Foundation & Strategy"]
  node_context["Project Context"]
  node_bootstrap["QA Bootstrap"]
  node_strategy["Test Strategy"]
  node_planning["Test Planning"]
  node_risk_exploration["Risk & Exploration"]
end

subgraph group_automation["Test Automation"]
  node_browser_automation["Browser Automation"]
  node_framework_testing["Framework Testing"]
  node_api_unit_mobile["API, Unit & Mobile"]
  node_visual_performance["Visual & Performance"]
end

subgraph group_specialized["Specialized Testing"]
  node_access_security["Accessibility & Security"]
  node_domain_testing["Domain Testing"]
  node_integration_testing["Integration Testing"]
end

subgraph group_ai_qa["AI-Augmented QA"]
  node_generation_triage["Generation & Triage"]
  node_system_testing["AI System Testing"]
  node_reliability_reproduction["Reliability & Reproduction"]
end

subgraph group_infrastructure["QA Infrastructure"]
  node_ci_environments["CI & Environments"]
  node_data_virtualization["Data & Virtualization"]
end

subgraph group_process_production["Process & Production"]
  node_metrics_dashboard["Metrics & Dashboards"]
  node_release_compliance["Release & Compliance"]
  node_production_observability["Production & Observability"]
end

node_user(("QA User"))
node_agent(("AI Agent"))
node_answer["QA Guidance"]

node_user -->|"asks QA question"| node_agent
node_agent -->|"reads project context"| node_context
node_agent -->|"applies when onboarding"| node_bootstrap
node_agent -->|"selects guidance"| node_strategy
node_agent -->|"selects guidance"| node_planning
node_agent -->|"selects guidance"| node_risk_exploration
node_agent -->|"selects guidance"| node_browser_automation
node_agent -->|"selects guidance"| node_framework_testing
node_agent -->|"selects guidance"| node_api_unit_mobile
node_agent -->|"selects guidance"| node_visual_performance
node_agent -->|"selects guidance"| node_access_security
node_agent -->|"selects guidance"| node_domain_testing
node_agent -->|"selects guidance"| node_integration_testing
node_agent -->|"selects guidance"| node_generation_triage
node_agent -->|"selects guidance"| node_system_testing
node_agent -->|"selects guidance"| node_reliability_reproduction
node_agent -->|"selects guidance"| node_ci_environments
node_agent -->|"selects guidance"| node_data_virtualization
node_agent -->|"selects guidance"| node_metrics_dashboard
node_agent -->|"selects guidance"| node_release_compliance
node_agent -->|"selects guidance"| node_production_observability
node_agent -->|"returns QA guidance"| node_answer

click node_context "https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-context"
click node_bootstrap "https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-bootstrap"
click node_strategy "https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-strategy"
click node_planning "https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-planning"
click node_risk_exploration "https://github.com/petrkindlmann/qa-skills/tree/main/skills/risk-based-testing"
click node_browser_automation "https://github.com/petrkindlmann/qa-skills/tree/main/skills/playwright-automation"
click node_framework_testing "https://github.com/petrkindlmann/qa-skills/tree/main/skills/cypress-automation"
click node_api_unit_mobile "https://github.com/petrkindlmann/qa-skills/tree/main/skills/api-testing"
click node_visual_performance "https://github.com/petrkindlmann/qa-skills/tree/main/skills/visual-testing"
click node_access_security "https://github.com/petrkindlmann/qa-skills/tree/main/skills/accessibility-testing"
click node_domain_testing "https://github.com/petrkindlmann/qa-skills/tree/main/skills/payment-testing"
click node_integration_testing "https://github.com/petrkindlmann/qa-skills/tree/main/skills/contract-testing"
click node_generation_triage "https://github.com/petrkindlmann/qa-skills/tree/main/skills/ai-test-generation"
click node_system_testing "https://github.com/petrkindlmann/qa-skills/tree/main/skills/ai-system-testing"
click node_reliability_reproduction "https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-reliability"
click node_ci_environments "https://github.com/petrkindlmann/qa-skills/tree/main/skills/ci-cd-integration"
click node_data_virtualization "https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-data-management"
click node_metrics_dashboard "https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-metrics"
click node_release_compliance "https://github.com/petrkindlmann/qa-skills/tree/main/skills/release-readiness"
click node_production_observability "https://github.com/petrkindlmann/qa-skills/tree/main/skills/testing-in-production"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_context,node_bootstrap,node_strategy,node_planning,node_risk_exploration,node_user toneBlue
class node_browser_automation,node_framework_testing,node_api_unit_mobile,node_visual_performance toneAmber
class node_access_security,node_domain_testing,node_integration_testing toneMint
class node_generation_triage,node_system_testing,node_reliability_reproduction toneRose
class node_ci_environments,node_data_virtualization,node_agent,node_answer toneIndigo
class node_metrics_dashboard,node_release_compliance,node_production_observability toneTeal
```

## Components

### Foundation & Strategy

- [Project Context](https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-context): `skills/qa-project-context`
- [QA Bootstrap](https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-project-bootstrap): `skills/qa-project-bootstrap`
- [Test Strategy](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-strategy): `skills/test-strategy`
- [Test Planning](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-planning): `skills/test-planning`
- [Risk & Exploration](https://github.com/petrkindlmann/qa-skills/tree/main/skills/risk-based-testing): `skills/risk-based-testing`

### Test Automation

- [Browser Automation](https://github.com/petrkindlmann/qa-skills/tree/main/skills/playwright-automation): `skills/playwright-automation`
- [Framework Testing](https://github.com/petrkindlmann/qa-skills/tree/main/skills/cypress-automation): `skills/cypress-automation`
- [API, Unit & Mobile](https://github.com/petrkindlmann/qa-skills/tree/main/skills/api-testing): `skills/api-testing`
- [Visual & Performance](https://github.com/petrkindlmann/qa-skills/tree/main/skills/visual-testing): `skills/visual-testing`

### Specialized Testing

- [Accessibility & Security](https://github.com/petrkindlmann/qa-skills/tree/main/skills/accessibility-testing): `skills/accessibility-testing`
- [Domain Testing](https://github.com/petrkindlmann/qa-skills/tree/main/skills/payment-testing): `skills/payment-testing`
- [Integration Testing](https://github.com/petrkindlmann/qa-skills/tree/main/skills/contract-testing): `skills/contract-testing`

### AI-Augmented QA

- [Generation & Triage](https://github.com/petrkindlmann/qa-skills/tree/main/skills/ai-test-generation): `skills/ai-test-generation`
- [AI System Testing](https://github.com/petrkindlmann/qa-skills/tree/main/skills/ai-system-testing): `skills/ai-system-testing`
- [Reliability & Reproduction](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-reliability): `skills/test-reliability`

### QA Infrastructure

- [CI & Environments](https://github.com/petrkindlmann/qa-skills/tree/main/skills/ci-cd-integration): `skills/ci-cd-integration`
- [Data & Virtualization](https://github.com/petrkindlmann/qa-skills/tree/main/skills/test-data-management): `skills/test-data-management`

### Process & Production

- [Metrics & Dashboards](https://github.com/petrkindlmann/qa-skills/tree/main/skills/qa-metrics): `skills/qa-metrics`
- [Release & Compliance](https://github.com/petrkindlmann/qa-skills/tree/main/skills/release-readiness): `skills/release-readiness`
- [Production & Observability](https://github.com/petrkindlmann/qa-skills/tree/main/skills/testing-in-production): `skills/testing-in-production`

### Other components

- **QA User**
- **AI Agent**
- **QA Guidance**

## Connections

- QA User → AI Agent: asks QA question
- AI Agent → Project Context: reads project context
- AI Agent → QA Bootstrap: applies when onboarding
- AI Agent → Test Strategy: selects guidance
- AI Agent → Test Planning: selects guidance
- AI Agent → Risk & Exploration: selects guidance
- AI Agent → Browser Automation: selects guidance
- AI Agent → Framework Testing: selects guidance
- AI Agent → API, Unit & Mobile: selects guidance
- AI Agent → Visual & Performance: selects guidance
- AI Agent → Accessibility & Security: selects guidance
- AI Agent → Domain Testing: selects guidance
- AI Agent → Integration Testing: selects guidance
- AI Agent → Generation & Triage: selects guidance
- AI Agent → AI System Testing: selects guidance
- AI Agent → Reliability & Reproduction: selects guidance
- AI Agent → CI & Environments: selects guidance
- AI Agent → Data & Virtualization: selects guidance
- AI Agent → Metrics & Dashboards: selects guidance
- AI Agent → Release & Compliance: selects guidance
- AI Agent → Production & Observability: selects guidance
- AI Agent → QA Guidance: returns QA guidance