SKILLS_GUIDE.md

Skills Quick Reference Guide

A guide for choosing the right skill for your task. For installation, see Quick Start. For the full project, see README.

---

When to Use Each Skill

Language Specialists

• Python Pro: Python development, type hints, async patterns, performance optimization
• TypeScript Pro: TypeScript advanced types, type guards, generics, utility types
• JavaScript Pro: Modern JavaScript, async patterns, ES2024+ features
• Go Pro: Go concurrency, interfaces, goroutines, channels
• Rust Engineer: Rust systems programming, ownership, lifetimes, async Rust
• SQL Pro: Advanced SQL, query optimization, window functions, CTEs
• C++ Pro: Modern C++, RAII, templates, performance optimization
• Swift Expert: Swift for iOS/macOS, SwiftUI, Combine, Concurrency
• Kotlin Specialist: Kotlin for Android, coroutines, Flow, Jetpack Compose
• C# Developer: C# .NET development, LINQ, async/await, modern features
• PHP Pro: Modern PHP, Laravel patterns, performance optimization
• Java Architect: Java enterprise, Spring ecosystem, design patterns

Backend Frameworks

• NestJS Expert: Building TypeScript backend APIs with NestJS
• Django Expert: Building Python web apps with Django/DRF
• FastAPI Expert: Building async Python APIs with FastAPI
• Spring Boot Engineer: Java enterprise applications with Spring Boot
• Laravel Specialist: PHP web applications with Laravel
• Rails Expert: Ruby on Rails web applications
• .NET Core Expert: .NET Core APIs and applications

Frontend & Mobile

• React Expert: Building React web applications
• Next.js Developer: Next.js App Router, Server Components, Server Actions
• Vue Expert: Vue 3 applications with Composition API and Pinia (TypeScript)
• Vue Expert (JS): Vue 3 applications with JavaScript only (JSDoc typing)
• Angular Architect: Angular applications with standalone components
• React Native Expert: Building cross-platform mobile apps (React Native)
• Flutter Expert: Building cross-platform apps with Flutter

Infrastructure & Cloud

• Kubernetes Specialist: K8s deployments, Helm charts, cluster management
• Terraform Engineer: Infrastructure as Code, multi-cloud provisioning
• Postgres Pro: PostgreSQL optimization, replication, advanced features
• Cloud Architect: AWS/Azure/GCP architecture, multi-cloud strategies
• Database Optimizer: Database performance tuning, indexing strategies

API & Architecture

• GraphQL Architect: GraphQL schema design, resolvers, federation
• API Designer: RESTful API design, OpenAPI, API versioning
• WebSocket Engineer: Real-time communication, WebSockets, Socket.IO
• Microservices Architect: Microservices patterns, service mesh, distributed systems
• MCP Developer: Model Context Protocol development and integration
• Architecture Designer: System design, choosing architectures, ADRs
• Feature Forge: Creating new features, gathering requirements, writing specs
• Spec Miner: Analyzing existing code, reverse-engineering specifications

Quality & Testing

• Test Master: Overall testing strategy (unit, integration, E2E, performance, security)
• Playwright Expert: Browser automation and E2E testing
• Code Reviewer: Conducting thorough code reviews
• Code Documenter: Adding inline documentation and API docs

DevOps & Operations

• DevOps Engineer: CI/CD, deployment, infrastructure, platform engineering
• Monitoring Expert: Logging, metrics, tracing, alerting, performance testing
• SRE Engineer: Site reliability, incident response, SLO/SLA management
• Chaos Engineer: Chaos testing, resilience engineering, fault injection
• CLI Developer: Command-line tools, CLI frameworks, shell integration

Security

• Secure Code Guardian: Writing secure code, preventing vulnerabilities
• Security Reviewer: Security code review, SAST analysis, penetration testing

Data & Machine Learning

• Pandas Pro: DataFrame manipulation, data cleaning, aggregation, time series
• Spark Engineer: Apache Spark, PySpark, distributed data processing, Spark SQL
• ML Pipeline: ML pipelines, MLflow, Kubeflow, feature stores, experiment tracking
• Prompt Engineer: LLM prompt design, chain-of-thought, few-shot learning, evaluation
• RAG Architect: RAG systems, vector databases, embeddings, semantic search
• Fine-Tuning Expert: LLM fine-tuning, LoRA, QLoRA, PEFT, model optimization

Platform Specialists

• Salesforce Developer: Apex, Lightning Web Components, SOQL, governor limits
• Shopify Expert: Liquid templating, Storefront API, Shopify apps, checkout extensions
• WordPress Pro: WordPress themes, plugins, Gutenberg blocks, WooCommerce
• Atlassian MCP: Jira/Confluence integration via MCP, JQL, CQL queries

Specialized

• Legacy Modernizer: Legacy code modernization, migration strategies
• Embedded Systems: Embedded development, IoT, firmware, real-time systems
• Game Developer: Game development, game engines, graphics, physics

Workflow

• Debugging Wizard: Systematic debugging across all languages
• Fullstack Guardian: Implementing features across full stack
• 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