# Skills Quick Reference Guide

A guide for choosing the right skill for your task. For installation, see [Quick Start](QUICKSTART.md). For the full project, see [README](README.md).

---

## When to Use Each Skill

### Language Specialists
- **[Python Pro](https://jeffallan.github.io/claude-skills/skills/language/python-pro/)**: Python development, type hints, async patterns, performance optimization
- **[TypeScript Pro](https://jeffallan.github.io/claude-skills/skills/language/typescript-pro/)**: TypeScript advanced types, type guards, generics, utility types
- **[JavaScript Pro](https://jeffallan.github.io/claude-skills/skills/language/javascript-pro/)**: Modern JavaScript, async patterns, ES2024+ features
- **[Go Pro](https://jeffallan.github.io/claude-skills/skills/language/golang-pro/)**: Go concurrency, interfaces, goroutines, channels
- **[Rust Engineer](https://jeffallan.github.io/claude-skills/skills/language/rust-engineer/)**: Rust systems programming, ownership, lifetimes, async Rust
- **[SQL Pro](https://jeffallan.github.io/claude-skills/skills/language/sql-pro/)**: Advanced SQL, query optimization, window functions, CTEs
- **[C++ Pro](https://jeffallan.github.io/claude-skills/skills/language/cpp-pro/)**: Modern C++, RAII, templates, performance optimization
- **[Swift Expert](https://jeffallan.github.io/claude-skills/skills/language/swift-expert/)**: Swift for iOS/macOS, SwiftUI, Combine, Concurrency
- **[Kotlin Specialist](https://jeffallan.github.io/claude-skills/skills/language/kotlin-specialist/)**: Kotlin for Android, coroutines, Flow, Jetpack Compose
- **[C# Developer](https://jeffallan.github.io/claude-skills/skills/language/csharp-developer/)**: C# .NET development, LINQ, async/await, modern features
- **[PHP Pro](https://jeffallan.github.io/claude-skills/skills/language/php-pro/)**: Modern PHP, Laravel patterns, performance optimization
- **[Java Architect](https://jeffallan.github.io/claude-skills/skills/language/java-architect/)**: Java enterprise, Spring ecosystem, design patterns

### Backend Frameworks
- **[NestJS Expert](https://jeffallan.github.io/claude-skills/skills/backend/nestjs-expert/)**: Building TypeScript backend APIs with NestJS
- **[Django Expert](https://jeffallan.github.io/claude-skills/skills/backend/django-expert/)**: Building Python web apps with Django/DRF
- **[FastAPI Expert](https://jeffallan.github.io/claude-skills/skills/backend/fastapi-expert/)**: Building async Python APIs with FastAPI
- **[Spring Boot Engineer](https://jeffallan.github.io/claude-skills/skills/backend/spring-boot-engineer/)**: Java enterprise applications with Spring Boot
- **[Laravel Specialist](https://jeffallan.github.io/claude-skills/skills/backend/laravel-specialist/)**: PHP web applications with Laravel
- **[Rails Expert](https://jeffallan.github.io/claude-skills/skills/backend/rails-expert/)**: Ruby on Rails web applications
- **[.NET Core Expert](https://jeffallan.github.io/claude-skills/skills/backend/dotnet-core-expert/)**: .NET Core APIs and applications

### Frontend & Mobile
- **[React Expert](https://jeffallan.github.io/claude-skills/skills/frontend/react-expert/)**: Building React web applications
- **[Next.js Developer](https://jeffallan.github.io/claude-skills/skills/frontend/nextjs-developer/)**: Next.js App Router, Server Components, Server Actions
- **[Vue Expert](https://jeffallan.github.io/claude-skills/skills/frontend/vue-expert/)**: Vue 3 applications with Composition API and Pinia (TypeScript)
- **[Vue Expert (JS)](https://jeffallan.github.io/claude-skills/skills/frontend/vue-expert-js/)**: Vue 3 applications with JavaScript only (JSDoc typing)
- **[Angular Architect](https://jeffallan.github.io/claude-skills/skills/frontend/angular-architect/)**: Angular applications with standalone components
- **[React Native Expert](https://jeffallan.github.io/claude-skills/skills/frontend/react-native-expert/)**: Building cross-platform mobile apps (React Native)
- **[Flutter Expert](https://jeffallan.github.io/claude-skills/skills/frontend/flutter-expert/)**: Building cross-platform apps with Flutter

### Infrastructure & Cloud
- **[Kubernetes Specialist](https://jeffallan.github.io/claude-skills/skills/infrastructure/kubernetes-specialist/)**: K8s deployments, Helm charts, cluster management
- **[Terraform Engineer](https://jeffallan.github.io/claude-skills/skills/infrastructure/terraform-engineer/)**: Infrastructure as Code, multi-cloud provisioning
- **[Postgres Pro](https://jeffallan.github.io/claude-skills/skills/infrastructure/postgres-pro/)**: PostgreSQL optimization, replication, advanced features
- **[Cloud Architect](https://jeffallan.github.io/claude-skills/skills/infrastructure/cloud-architect/)**: AWS/Azure/GCP architecture, multi-cloud strategies
- **[Database Optimizer](https://jeffallan.github.io/claude-skills/skills/infrastructure/database-optimizer/)**: Database performance tuning, indexing strategies

### API & Architecture
- **[GraphQL Architect](https://jeffallan.github.io/claude-skills/skills/api-architecture/graphql-architect/)**: GraphQL schema design, resolvers, federation
- **[API Designer](https://jeffallan.github.io/claude-skills/skills/api-architecture/api-designer/)**: RESTful API design, OpenAPI, API versioning
- **[WebSocket Engineer](https://jeffallan.github.io/claude-skills/skills/api-architecture/websocket-engineer/)**: Real-time communication, WebSockets, Socket.IO
- **[Microservices Architect](https://jeffallan.github.io/claude-skills/skills/api-architecture/microservices-architect/)**: Microservices patterns, service mesh, distributed systems
- **[MCP Developer](https://jeffallan.github.io/claude-skills/skills/api-architecture/mcp-developer/)**: Model Context Protocol development and integration
- **[Architecture Designer](https://jeffallan.github.io/claude-skills/skills/api-architecture/architecture-designer/)**: System design, choosing architectures, ADRs
- **[Feature Forge](https://jeffallan.github.io/claude-skills/skills/workflow/feature-forge/)**: Creating new features, gathering requirements, writing specs
- **[Spec Miner](https://jeffallan.github.io/claude-skills/skills/workflow/spec-miner/)**: Analyzing existing code, reverse-engineering specifications

### Quality & Testing
- **[Test Master](https://jeffallan.github.io/claude-skills/skills/quality/test-master/)**: Overall testing strategy (unit, integration, E2E, performance, security)
- **[Playwright Expert](https://jeffallan.github.io/claude-skills/skills/quality/playwright-expert/)**: Browser automation and E2E testing
- **[Code Reviewer](https://jeffallan.github.io/claude-skills/skills/quality/code-reviewer/)**: Conducting thorough code reviews
- **[Code Documenter](https://jeffallan.github.io/claude-skills/skills/quality/code-documenter/)**: Adding inline documentation and API docs

### DevOps & Operations
- **[DevOps Engineer](https://jeffallan.github.io/claude-skills/skills/devops/devops-engineer/)**: CI/CD, deployment, infrastructure, platform engineering
- **[Monitoring Expert](https://jeffallan.github.io/claude-skills/skills/devops/monitoring-expert/)**: Logging, metrics, tracing, alerting, performance testing
- **[SRE Engineer](https://jeffallan.github.io/claude-skills/skills/devops/sre-engineer/)**: Site reliability, incident response, SLO/SLA management
- **[Chaos Engineer](https://jeffallan.github.io/claude-skills/skills/devops/chaos-engineer/)**: Chaos testing, resilience engineering, fault injection
- **[CLI Developer](https://jeffallan.github.io/claude-skills/skills/devops/cli-developer/)**: Command-line tools, CLI frameworks, shell integration

### Security
- **[Secure Code Guardian](https://jeffallan.github.io/claude-skills/skills/security/secure-code-guardian/)**: Writing secure code, preventing vulnerabilities
- **[Security Reviewer](https://jeffallan.github.io/claude-skills/skills/security/security-reviewer/)**: Security code review, SAST analysis, penetration testing

### Data & Machine Learning
- **[Pandas Pro](https://jeffallan.github.io/claude-skills/skills/data-ml/pandas-pro/)**: DataFrame manipulation, data cleaning, aggregation, time series
- **[Spark Engineer](https://jeffallan.github.io/claude-skills/skills/data-ml/spark-engineer/)**: Apache Spark, PySpark, distributed data processing, Spark SQL
- **[ML Pipeline](https://jeffallan.github.io/claude-skills/skills/data-ml/ml-pipeline/)**: ML pipelines, MLflow, Kubeflow, feature stores, experiment tracking
- **[Prompt Engineer](https://jeffallan.github.io/claude-skills/skills/data-ml/prompt-engineer/)**: LLM prompt design, chain-of-thought, few-shot learning, evaluation
- **[RAG Architect](https://jeffallan.github.io/claude-skills/skills/data-ml/rag-architect/)**: RAG systems, vector databases, embeddings, semantic search
- **[Fine-Tuning Expert](https://jeffallan.github.io/claude-skills/skills/data-ml/fine-tuning-expert/)**: LLM fine-tuning, LoRA, QLoRA, PEFT, model optimization

### Platform Specialists
- **[Salesforce Developer](https://jeffallan.github.io/claude-skills/skills/platform/salesforce-developer/)**: Apex, Lightning Web Components, SOQL, governor limits
- **[Shopify Expert](https://jeffallan.github.io/claude-skills/skills/platform/shopify-expert/)**: Liquid templating, Storefront API, Shopify apps, checkout extensions
- **[WordPress Pro](https://jeffallan.github.io/claude-skills/skills/platform/wordpress-pro/)**: WordPress themes, plugins, Gutenberg blocks, WooCommerce
- **[Atlassian MCP](https://jeffallan.github.io/claude-skills/skills/platform/atlassian-mcp/)**: Jira/Confluence integration via MCP, JQL, CQL queries

### Specialized
- **[Legacy Modernizer](https://jeffallan.github.io/claude-skills/skills/specialized/legacy-modernizer/)**: Legacy code modernization, migration strategies
- **[Embedded Systems](https://jeffallan.github.io/claude-skills/skills/specialized/embedded-systems/)**: Embedded development, IoT, firmware, real-time systems
- **[Game Developer](https://jeffallan.github.io/claude-skills/skills/specialized/game-developer/)**: Game development, game engines, graphics, physics

### Workflow
- **[Debugging Wizard](https://jeffallan.github.io/claude-skills/skills/quality/debugging-wizard/)**: Systematic debugging across all languages
- **[Fullstack Guardian](https://jeffallan.github.io/claude-skills/skills/security/fullstack-guardian/)**: Implementing features across full stack
- **[The Fool](https://jeffallan.github.io/claude-skills/skills/workflow/the-fool/)**: Challenge ideas and decisions with 5 structured reasoning modes

## Skill Workflows

### New Feature Development
1. **Feature Forge** - Define requirements and spec
2. **Architecture Designer** - Design system architecture (if complex)
3. **Fullstack Guardian** + Framework Skills - Implement
4. **Test Master** + **Playwright Expert** - Test comprehensively
5. **Code Reviewer** - Review code
6. **Security Reviewer** - Security review
7. **DevOps Engineer** - Deploy
8. **Monitoring Expert** - Add observability

### Bug Fixing
1. **Debugging Wizard** - Identify root cause
2. **Fullstack Guardian** + Framework Skills - Fix
3. **Test Master** - Add regression tests
4. **Code Reviewer** - Review fix
5. **DevOps Engineer** - Deploy

### Code Review Process
1. **Code Reviewer** - General code review
2. **Security Reviewer** - Security-focused review
3. **Architecture Designer** - Architectural review (if needed)

### Legacy Code Analysis
1. **Spec Miner** - Reverse-engineer specs
2. **Architecture Designer** - Document architecture
3. **Code Documenter** - Add missing documentation
4. **Security Reviewer** - Security audit

## Decision Trees

### Language Selection
- **Python Development** → Python Pro
- **TypeScript/JavaScript** → TypeScript Pro / JavaScript Pro
- **Go Services** → Go Pro
- **Systems Programming** → Rust Engineer / C++ Pro
- **iOS/macOS** → Swift Expert
- **Android** → Kotlin Specialist
- **Enterprise .NET** → C# Developer
- **Enterprise Java** → Java Architect
- **PHP Web** → PHP Pro
- **Database Work** → SQL Pro

### Backend Framework
- **TypeScript API** → NestJS Expert
- **Python Django** → Django Expert
- **Python Async** → FastAPI Expert
- **Java Enterprise** → Spring Boot Engineer
- **PHP Modern** → Laravel Specialist
- **Ruby Web** → Rails Expert
- **.NET APIs** → .NET Core Expert

### Frontend Framework
- **React Web** → React Expert
- **React SSR/SSG** → Next.js Developer
- **Vue Apps (TypeScript)** → Vue Expert
- **Vue Apps (JavaScript)** → Vue Expert (JS)
- **Angular Apps** → Angular Architect
- **Mobile (JavaScript)** → React Native Expert
- **Mobile (Dart)** → Flutter Expert

### Infrastructure & Cloud
- **Container Orchestration** → Kubernetes Specialist
- **Infrastructure as Code** → Terraform Engineer
- **Cloud Architecture** → Cloud Architect
- **Database Performance** → Postgres Pro / Database Optimizer

### API Design
- **GraphQL** → GraphQL Architect
- **REST API** → API Designer
- **Real-time** → WebSocket Engineer
- **Microservices** → Microservices Architect
- **MCP Integration** → MCP Developer

### Data & Machine Learning
- **DataFrame Operations** → Pandas Pro
- **Big Data Processing** → Spark Engineer
- **ML Training Pipelines** → ML Pipeline
- **LLM Prompts** → Prompt Engineer
- **RAG Systems** → RAG Architect
- **Model Fine-Tuning** → Fine-Tuning Expert

### Platform Development
- **Salesforce CRM** → Salesforce Developer
- **Shopify E-commerce** → Shopify Expert
- **WordPress Sites** → WordPress Pro
- **Jira/Confluence** → Atlassian MCP

### Testing
- **E2E Browser Tests** → Playwright Expert
- **All Other Testing** → Test Master

### Operations
- **CI/CD & Deployment** → DevOps Engineer
- **Observability** → Monitoring Expert
- **Reliability** → SRE Engineer
- **Resilience Testing** → Chaos Engineer
- **CLI Tools** → CLI Developer

### Critical Thinking
- **Surface Assumptions** → Common Ground (command)
- **Challenge Decisions** → The Fool
- **Evaluate Code** → Code Reviewer
- **Audit Security** → Security Reviewer

## Skill Combinations

Common combinations for maximum effectiveness:

### Full Feature Development
- Feature Forge + Fullstack Guardian + Framework Skills + Test Master + DevOps Engineer

### Security-Focused Development
- Secure Code Guardian + Fullstack Guardian + Security Reviewer + Test Master

### Performance Optimization
- Architecture Designer + Monitoring Expert + Framework Skills + Database Optimizer

### Documentation Sprint
- Code Documenter + Spec Miner + Architecture Designer

### Cloud-Native Development
- Kubernetes Specialist + Terraform Engineer + Cloud Architect + SRE Engineer + Monitoring Expert

### API Development
- API Designer + GraphQL Architect + WebSocket Engineer + Microservices Architect

### Mobile Development
- React Native Expert / Flutter Expert + API Designer + DevOps Engineer

### Game Development
- Game Developer + C++ Pro + Performance Optimization + Graphics Programming

### Legacy Migration
- Legacy Modernizer + Architecture Designer + Language Specialists + Test Master + Security Reviewer

### Platform Engineering
- DevOps Engineer + Kubernetes Specialist + Terraform Engineer + Monitoring Expert + SRE Engineer

### Embedded/IoT
- Embedded Systems + Rust Engineer / C++ Pro + Security Reviewer

### Data & ML Pipeline
- Pandas Pro + Spark Engineer + ML Pipeline + Monitoring Expert

### AI/LLM Development
- Prompt Engineer + RAG Architect + Fine-Tuning Expert + Python Pro

### E-commerce Platform
- Shopify Expert + React Expert + API Designer + DevOps Engineer

### Decision Validation
- Common Ground (surface assumptions) + The Fool (stress-test the decision) + Architecture Designer (document refined decision)

### CRM Development
- Salesforce Developer + API Designer + Security Reviewer + Test Master

### Enterprise Java
- Java Architect + Spring Boot Engineer + Microservices Architect + DevOps Engineer

### Modern Web App
- Next.js Developer / Vue Expert / Angular Architect + TypeScript Pro + API Designer + DevOps Engineer

## Examples

### Good Prompts
- "Help me design a microservices architecture for an e-commerce platform" → Microservices Architect + Architecture Designer
- "Implement user authentication in my NestJS API" → NestJS Expert + Secure Code Guardian
- "Debug this memory leak in my React app" → Debugging Wizard + React Expert
- "Review this code for security issues" → Security Reviewer
- "Set up monitoring for my FastAPI application" → Monitoring Expert + FastAPI Expert
- "Build a GraphQL API with subscriptions" → GraphQL Architect + WebSocket Engineer
- "Deploy a Python app to Kubernetes" → Kubernetes Specialist + Python Pro
- "Optimize PostgreSQL queries" → Postgres Pro + SQL Pro
- "Migrate from Angular to React" → Legacy Modernizer + React Expert
- "Create a CLI tool in Go" → CLI Developer + Go Pro
- "Set up chaos testing for microservices" → Chaos Engineer + Microservices Architect
- "Build a Next.js app with server components" → Next.js Developer + TypeScript Pro
- "Implement WebSocket chat" → WebSocket Engineer + API Designer
- "Terraform setup for AWS multi-region" → Terraform Engineer + Cloud Architect
- "Build a game engine in C++" → Game Developer + C++ Pro
- "Modernize legacy Java monolith" → Legacy Modernizer + Java Architect + Microservices Architect

### Language-Specific
- "Write idiomatic Rust with async" → Rust Engineer
- "TypeScript generics for API client" → TypeScript Pro
- "Python type hints and protocols" → Python Pro
- "Go channels and concurrency patterns" → Go Pro
- "SwiftUI reactive patterns" → Swift Expert
- "Kotlin coroutines best practices" → Kotlin Specialist
- "Advanced SQL window functions" → SQL Pro

### Framework-Specific
- "Spring Boot microservice architecture" → Spring Boot Engineer
- "Laravel API with queues" → Laravel Specialist
- "Rails with Hotwire and Turbo" → Rails Expert
- ".NET Core minimal APIs" → .NET Core Expert
- "Vue 3 Composition API patterns" → Vue Expert
- "Angular signals and standalone components" → Angular Architect

### Infrastructure & Cloud
- "Kubernetes autoscaling and HPA" → Kubernetes Specialist
- "Multi-cloud Terraform modules" → Terraform Engineer
- "AWS serverless architecture" → Cloud Architect
- "PostgreSQL replication setup" → Postgres Pro
- "Database indexing strategy" → Database Optimizer

### Specific Requests
- "Generate OpenAPI docs for my Django REST API" → Code Documenter + API Designer
- "Write Playwright tests for the login flow" → Playwright Expert
- "Analyze this legacy codebase and create a spec" → Spec Miner
- "Help me implement RBAC in NestJS" → NestJS Expert + Secure Code Guardian
- "Set up SRE practices and SLOs" → SRE Engineer + Monitoring Expert
- "Design MCP server for tool integration" → MCP Developer
- "Embedded firmware for IoT device" → Embedded Systems + Rust Engineer

### Data & ML
- "Clean and transform CSV data with pandas" → Pandas Pro
- "Build a PySpark ETL pipeline" → Spark Engineer
- "Set up MLflow experiment tracking" → ML Pipeline
- "Design prompts for classification task" → Prompt Engineer
- "Build a RAG system with Pinecone" → RAG Architect
- "Fine-tune Llama 2 with LoRA" → Fine-Tuning Expert

### Platform Development
- "Build Lightning Web Component for Salesforce" → Salesforce Developer
- "Create custom Shopify checkout extension" → Shopify Expert
- "Develop WordPress plugin with Gutenberg blocks" → WordPress Pro
- "Query Jira issues via MCP server" → Atlassian MCP
