>_

router-operations

Master orchestration for routing QA, testing, DevOps, observability, and git workflow questions through 15+ operational skills

$ インストール

git clone https://github.com/vasilyu1983/AI-Agents-public /tmp/AI-Agents-public && cp -r /tmp/AI-Agents-public/frameworks/claude-code-kit/framework/skills/router-operations ~/.claude/skills/AI-Agents-public

// tip: Run this command in your terminal to install the skill

SKILL.md
View on GitHub →

name: router-operations description: Master orchestration for routing QA, testing, DevOps, observability, and git workflow questions through 15+ operational skills version: "1.0"

Router: Operations

Master orchestrator that routes quality assurance, testing, deployment, observability, and git workflow questions through the complete operations skill set.

Decision Tree: Where to Start?

OPERATIONS QUESTION
    │
    ├─► "How to test this?" ────────────► qa-testing-strategy
    │                                      └─► Unit, integration, E2E, BDD
    │
    ├─► "Write Playwright tests" ───────► qa-testing-playwright
    │                                      └─► E2E, page objects, CI/CD
    │
    ├─► "Test iOS app" ─────────────────► qa-testing-ios
    │                                      └─► XCTest, simulator, UI testing
    │
    ├─► "Debug this issue" ─────────────► qa-debugging
    │                                      └─► Troubleshooting, logging, profiling
    │
    ├─► "Improve error handling" ───────► qa-resilience
    │                                      └─► Circuit breakers, retries, chaos
    │
    ├─► "Setup monitoring" ─────────────► qa-observability
    │                                      └─► OpenTelemetry, tracing, SLOs
    │
    ├─► "Refactor this code" ───────────► qa-refactoring
    │                                      └─► Code smells, tech debt, patterns
    │
    ├─► "Check docs coverage" ──────────► qa-docs-coverage
    │                                      └─► Gap analysis, coverage reports
    │
    ├─► "Test LLM agent" ───────────────► qa-agent-testing
    │                                      └─► Test suites, scoring, refusals
    │
    ├─► "Deploy to production" ─────────► ops-devops-platform
    │                                      └─► K8s, Terraform, GitOps, SRE
    │
    ├─► "Write commit message" ─────────► git-commit-message
    │                                      └─► Conventional commits
    │
    ├─► "Git workflow / branching" ─────► git-workflow
    │                                      └─► GitHub Flow, PRs, reviews
    │
    ├─► "Create documentation" ─────────► docs-codebase
    │                                      └─► README, API docs, ADRs
    │
    ├─► "Write PRD for AI agent" ───────► docs-ai-prd
    │                                      └─► CLAUDE.md, agentic planning
    │
    └─► "Full operations audit" ────────► COMPREHENSIVE ANALYSIS
                                           └─► All operational dimensions

Domain Detection

Domain 1: TESTING & QA

Triggers: "test", "testing", "QA", "quality", "coverage", "assertion", "mock", "E2E", "unit test", "integration test"

Primary Skills:

SkillWhen to Use
qa-testing-strategyOverall test strategy, frameworks
qa-testing-playwrightE2E web testing, browser automation
qa-testing-iosiOS simulator testing, XCTest
qa-agent-testingLLM agent/persona testing

Skill Chain - Complete Test Setup:

qa-testing-strategy (strategy) → qa-testing-playwright (E2E)
    → qa-testing-ios (mobile) → qa-agent-testing (AI agents)

Domain 2: DEBUGGING & RESILIENCE

Triggers: "debug", "error", "bug", "crash", "exception", "retry", "circuit breaker", "timeout", "failure"

Primary Skills:

SkillWhen to Use
qa-debuggingTroubleshooting, logging, profiling
qa-resilienceError handling, circuit breakers, chaos
qa-refactoringCode quality, tech debt

Skill Chain - Production Issues:

qa-debugging (identify issue) → qa-resilience (prevent recurrence)
    → qa-refactoring (improve code quality)

Domain 3: OBSERVABILITY & MONITORING

Triggers: "monitor", "metrics", "tracing", "logging", "SLO", "SLI", "alerting", "APM", "OpenTelemetry"

Primary Skills:

SkillWhen to Use
qa-observabilityFull observability stack
ops-devops-platformInfrastructure monitoring

Skill Chain - Observability Setup:

qa-observability (instrumentation) → ops-devops-platform (infrastructure)
    → qa-debugging (incident response)

Domain 4: DEPLOYMENT & INFRASTRUCTURE

Triggers: "deploy", "Kubernetes", "Docker", "Terraform", "CI/CD", "GitOps", "infrastructure", "SRE"

Primary Skills:

SkillWhen to Use
ops-devops-platformFull DevOps stack
git-workflowDeployment workflows

Skill Chain - Production Deployment:

git-workflow (branching strategy) → ops-devops-platform (CI/CD + K8s)
    → qa-observability (monitoring) → qa-resilience (failure handling)

Domain 5: GIT & VERSION CONTROL

Triggers: "git", "commit", "branch", "PR", "pull request", "merge", "rebase", "code review"

Primary Skills:

SkillWhen to Use
git-commit-messageConventional commit messages
git-workflowBranching, PRs, reviews

Skill Chain - Git Workflow:

git-workflow (strategy) → git-commit-message (commits)
    → software-code-review (PR reviews)

Domain 6: DOCUMENTATION

Triggers: "documentation", "README", "API docs", "ADR", "PRD", "changelog", "docs"

Primary Skills:

SkillWhen to Use
docs-codebaseTechnical documentation
docs-ai-prdPRDs for AI agents
qa-docs-coverageDocumentation gaps

Skill Chain - Documentation:

qa-docs-coverage (audit) → docs-codebase (write docs)
    → docs-ai-prd (if AI project)

Skill Registry

Testing & QA (5)

SkillPurposeKey Outputs
qa-testing-strategyTest strategyTest pyramid, frameworks, coverage
qa-testing-playwrightE2E web testingPage objects, auth flows, CI
qa-testing-iosiOS testingXCTest, simulator, UI tests
qa-agent-testingLLM agent testingTest suites, scoring rubrics
qa-docs-coverageDocs auditGap analysis, coverage reports

Debugging & Quality (3)

SkillPurposeKey Outputs
qa-debuggingDebuggingTroubleshooting, logging, profiling
qa-resilienceResilienceCircuit breakers, retries, chaos
qa-refactoringCode qualitySmell detection, refactoring

Observability (1)

SkillPurposeKey Outputs
qa-observabilityMonitoringOpenTelemetry, SLOs, APM

DevOps & Infrastructure (1)

SkillPurposeKey Outputs
ops-devops-platformDevOpsK8s, Terraform, GitOps, SRE

Git & Version Control (2)

SkillPurposeKey Outputs
git-commit-messageCommitsConventional commit messages
git-workflowWorkflowsBranching, PRs, reviews

Documentation (3)

SkillPurposeKey Outputs
docs-codebaseTech docsREADME, API docs, ADRs
docs-ai-prdAI PRDsAgent specs, CLAUDE.md
qa-docs-coverageDocs gapsCoverage audit

Routing Logic

Keyword-Based Routing

KEYWORDS -> SKILL MAPPING

"test strategy", "test pyramid", "coverage" -> qa-testing-strategy
"Playwright", "E2E", "browser test", "page object" -> qa-testing-playwright
"iOS test", "XCTest", "simulator", "xcrun" -> qa-testing-ios
"agent test", "LLM test", "persona test", "refusal" -> qa-agent-testing
"docs coverage", "undocumented", "gap analysis" -> qa-docs-coverage

"debug", "troubleshoot", "stack trace", "profiling" -> qa-debugging
"resilience", "circuit breaker", "retry", "chaos" -> qa-resilience
"refactor", "code smell", "tech debt", "clean code" -> qa-refactoring

"observability", "tracing", "metrics", "SLO", "SLI" -> qa-observability
"OpenTelemetry", "APM", "distributed tracing" -> qa-observability

"deploy", "Kubernetes", "K8s", "Terraform" -> ops-devops-platform
"Docker", "container", "GitOps", "ArgoCD" -> ops-devops-platform
"CI/CD", "pipeline", "GitHub Actions" -> ops-devops-platform
"SRE", "reliability", "incident" -> ops-devops-platform

"commit message", "conventional commit" -> git-commit-message
"git workflow", "branching", "PR", "code review" -> git-workflow
"merge", "rebase", "trunk-based" -> git-workflow

"README", "API docs", "ADR", "changelog" -> docs-codebase
"PRD", "CLAUDE.md", "AI agent spec" -> docs-ai-prd

Context-Based Routing

User ContextPrimary SkillSupporting Skills
Starting testingqa-testing-strategyqa-testing-playwright, qa-testing-ios
Production bugqa-debuggingqa-resilience, qa-observability
Deploying appops-devops-platformgit-workflow, qa-observability
Code qualityqa-refactoringqa-debugging, software-code-review
Git setupgit-workflowgit-commit-message
Writing docsdocs-codebaseqa-docs-coverage
Testing AI agentqa-agent-testingai-agents, ai-prompt-engineering

Skill Chain Patterns

Pattern 1: Complete Test Strategy

START
  │
  ▼
qa-testing-strategy ────────► Test pyramid + frameworks
  │
  ├─────────────────────────────────────┐
  ▼                                     ▼
qa-testing-playwright ► E2E    qa-testing-ios ► Mobile
  │                                     │
  └─────────────────┬───────────────────┘
                    ▼
           qa-agent-testing ──► AI agents (if applicable)
                    │
                    ▼
              COMPLETE TEST SUITE

Pattern 2: Production Readiness

START
  │
  ▼
qa-testing-strategy ────────► Tests pass
  │
  ▼
qa-resilience ──────────────► Error handling
  │
  ▼
qa-observability ───────────► Monitoring setup
  │
  ▼
ops-devops-platform ────────► CI/CD + deployment
  │
  ▼
git-workflow ───────────────► Release process
  │
  ▼
PRODUCTION READY

Pattern 3: Incident Response

INCIDENT
  │
  ▼
qa-debugging ───────────────► Root cause analysis
  │
  ▼
qa-observability ───────────► Check metrics/traces
  │
  ▼
qa-resilience ──────────────► Prevent recurrence
  │
  ▼
qa-refactoring ─────────────► Fix underlying issues
  │
  ▼
docs-codebase ──────────────► Post-mortem doc
  │
  ▼
INCIDENT RESOLVED

Pattern 4: LLM Agent Testing

START
  │
  ▼
qa-agent-testing ───────────► Test suite design
  │
  ├─► Must-ace tasks ────────► Core functionality
  ├─► Refusal edge cases ────► Safety boundaries
  ├─► Scoring rubric ────────► 6-dimension evaluation
  │
  ▼
ai-prompt-engineering ──────► Prompt improvements
  │
  ▼
VALIDATED AGENT

Pattern 5: Documentation Audit

START
  │
  ▼
qa-docs-coverage ───────────► Gap analysis
  │
  ▼
docs-codebase ──────────────► Write missing docs
  │
  ▼
docs-ai-prd ────────────────► AI agent specs (if applicable)
  │
  ▼
git-workflow ───────────────► PR with docs
  │
  ▼
DOCS COMPLETE

Comprehensive Analysis Mode

For full operations audit, invoke skills in parallel:

Layer 1: Quality Assessment (Parallel)

SkillOutputPurpose
qa-testing-strategyTest coverageWhat's tested?
qa-docs-coverageDoc coverageWhat's documented?
qa-refactoringCode qualityTech debt assessment

Layer 2: Operational Readiness

SkillOutputPurpose
qa-resilienceError handlingFailure modes
qa-observabilityMonitoringVisibility gaps
ops-devops-platformInfrastructureDeployment gaps

Layer 3: Process

SkillOutputPurpose
git-workflowGit practicesProcess gaps
git-commit-messageCommit qualityChangelog readiness

Cross-Router Handoffs

To router-engineering

When user needs implementation:

  • "Build the fix" → Route to software-backend or software-frontend
  • "Implement retry logic" → Route to software-backend
  • "Add UI for monitoring" → Route to software-frontend

To router-startup

When user shifts to business:

  • "Is this ready to launch?" → Route to startup-go-to-market
  • "How to price monitoring service?" → Route to startup-business-models

From router-engineering

When router-engineering detects ops needs:

  • "How do I test this?" → Route here
  • "Deploy to production" → Route here
  • "Setup CI/CD" → Route here

Quality Gates

Pre-Deployment Checklist

GateSkillCriteria
Tests passqa-testing-strategy>80% coverage
E2E passqa-testing-playwrightCritical flows green
Error handlingqa-resilienceCircuit breakers configured
Monitoringqa-observabilitySLOs defined, alerts set
Docsqa-docs-coverageREADME, API docs complete
SecurityRoute to software-security-appsecOWASP checklist

Post-Deployment Checklist

GateSkillCriteria
Metrics flowingqa-observabilityDashboards populated
Alerts workingqa-observabilityTest alert fired
Logs searchableqa-debuggingCan query recent logs
Rollback testedops-devops-platformRollback procedure verified

Output Templates

Quick Analysis Output

## Operations Analysis: {{TOPIC}}

**Domain Detected**: {{DOMAIN}}
**Primary Skill**: {{SKILL}}
**Supporting Skills**: {{LIST}}

### Current State
- Tests: {{TEST_STATUS}}
- Monitoring: {{MONITORING_STATUS}}
- Docs: {{DOCS_STATUS}}

### Recommended Actions
1. {{ACTION_1}} - Use {{SKILL}}
2. {{ACTION_2}} - Use {{SKILL}}

### Skills to Invoke
- {{SKILL_1}}: {{WHY}}
- {{SKILL_2}}: {{WHY}}

Operations Audit Output

## Operations Audit: {{PROJECT}}

### Testing
- Strategy: {{STATUS}} - {{NOTES}}
- E2E Coverage: {{%}}
- Agent Tests: {{STATUS}}

### Resilience
- Error Handling: {{STATUS}}
- Circuit Breakers: {{STATUS}}
- Retry Policies: {{STATUS}}

### Observability
- Metrics: {{STATUS}}
- Tracing: {{STATUS}}
- Logging: {{STATUS}}
- SLOs: {{STATUS}}

### Infrastructure
- CI/CD: {{STATUS}}
- Deployment: {{STATUS}}
- Rollback: {{STATUS}}

### Documentation
- README: {{STATUS}}
- API Docs: {{STATUS}}
- ADRs: {{STATUS}}

### Priority Actions
1. {{HIGH_PRIORITY_1}}
2. {{HIGH_PRIORITY_2}}
3. {{HIGH_PRIORITY_3}}

Resources

ResourcePurpose
routing-logic.mdDetailed routing rules
quality-gates.mdDeployment checklists
incident-response.mdIncident playbook

Templates

TemplatePurpose
operations-audit.mdFull audit report
test-strategy.mdTest planning
incident-postmortem.mdPost-mortem doc

Data

FilePurpose
skill-registry.jsonOperations skills index
sources.jsonReference sources

Repository

vasilyu1983
vasilyu1983
Author
vasilyu1983/AI-Agents-public/frameworks/claude-code-kit/framework/skills/router-operations
21
Stars
6
Forks
Updated6d ago
Added1w ago

Actions

View on GitHubDownload ZIPReport Issue

Related Skills

skill-creator
openai/codex
54.7k
skill-installer
openai/codex
54.7k
Command Development
anthropics/claude-code
47.9k
Plugin Structure
anthropics/claude-code
47.9k
Plugin Settings
anthropics/claude-code
47.9k