agents/docs/agent-skills.md

# Agent Skills

Agent Skills are modular packages that extend Claude's capabilities with specialized domain knowledge, following Anthropic's [Agent Skills Specification](https://github.com/anthropics/skills/blob/main/agent_skills_spec.md). This plugin ecosystem includes **107 specialized skills** across 18 plugins, enabling progressive disclosure and efficient token usage.

## Overview

Skills provide Claude with deep expertise in specific domains without loading everything into context upfront. Each skill includes:

- **YAML Frontmatter**: Name and activation criteria
- **Progressive Disclosure**: Metadata → Instructions → Resources
- **Activation Triggers**: Clear "Use when" clauses for automatic invocation

## Skills by Plugin

### Kubernetes Operations (4 skills)

| Skill | Description |
|-------|-------------|
| **k8s-manifest-generator** | Create production-ready Kubernetes manifests for Deployments, Services, ConfigMaps, and Secrets following best practices |
| **helm-chart-scaffolding** | Design, organize, and manage Helm charts for templating and packaging Kubernetes applications |
| **gitops-workflow** | Implement GitOps workflows with ArgoCD and Flux for automated, declarative deployments |
| **k8s-security-policies** | Implement Kubernetes security policies including NetworkPolicy, PodSecurityPolicy, and RBAC |

### LLM Application Development (8 skills)

| Skill | Description |
|-------|-------------|
| **langchain-architecture** | Design LLM applications using LangChain framework with agents, memory, and tool integration |
| **prompt-engineering-patterns** | Master advanced prompt engineering techniques for LLM performance and reliability |
| **rag-implementation** | Build Retrieval-Augmented Generation systems with vector databases and semantic search |
| **llm-evaluation** | Implement comprehensive evaluation strategies with automated metrics and benchmarking |
| **embedding-strategies** | Design embedding pipelines for text, images, and multimodal content with optimal chunking |
| **similarity-search-patterns** | Implement efficient similarity search with ANN algorithms and distance metrics |
| **vector-index-tuning** | Optimize vector index performance with HNSW, IVF, and hybrid configurations |
| **hybrid-search-implementation** | Combine vector and keyword search for improved retrieval accuracy |

### Backend Development (9 skills)

| Skill | Description |
|-------|-------------|
| **api-design-principles** | Master REST and GraphQL API design for intuitive, scalable, and maintainable APIs |
| **architecture-patterns** | Implement Clean Architecture, Hexagonal Architecture, and Domain-Driven Design |
| **microservices-patterns** | Design microservices with service boundaries, event-driven communication, and resilience |
| **workflow-orchestration-patterns** | Design durable workflows with Temporal for distributed systems, saga patterns, and state management |
| **temporal-python-testing** | Test Temporal workflows with pytest, time-skipping, and mocking strategies for comprehensive coverage |
| **event-store-design** | Design event stores with optimized schemas, snapshots, and stream partitioning |
| **cqrs-implementation** | Implement CQRS with separate read/write models and eventual consistency patterns |
| **projection-patterns** | Build efficient projections from event streams for read-optimized views |
| **saga-orchestration** | Design distributed sagas with compensation logic and failure handling |

### Developer Essentials (11 skills)

| Skill | Description |
|-------|-------------|
| **git-advanced-workflows** | Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog |
| **sql-optimization-patterns** | Optimize SQL queries, indexing strategies, and EXPLAIN analysis for database performance |
| **error-handling-patterns** | Implement robust error handling with exceptions, Result types, and graceful degradation |
| **code-review-excellence** | Provide effective code reviews with constructive feedback and systematic analysis |
| **e2e-testing-patterns** | Build reliable E2E test suites with Playwright and Cypress for critical user workflows |
| **auth-implementation-patterns** | Implement authentication and authorization with JWT, OAuth2, sessions, and RBAC |
| **debugging-strategies** | Master systematic debugging techniques, profiling tools, and root cause analysis |
| **monorepo-management** | Manage monorepos with Turborepo, Nx, and pnpm workspaces for scalable multi-package projects |
| **nx-workspace-patterns** | Configure Nx workspaces with computation caching and affected commands |
| **turborepo-caching** | Optimize Turborepo builds with remote caching and pipeline configuration |
| **bazel-build-optimization** | Design Bazel builds with hermetic actions and remote execution |

### Blockchain & Web3 (4 skills)

| Skill | Description |
|-------|-------------|
| **defi-protocol-templates** | Implement DeFi protocols with templates for staking, AMMs, governance, and lending |
| **nft-standards** | Implement NFT standards (ERC-721, ERC-1155) with metadata and marketplace integration |
| **solidity-security** | Master smart contract security to prevent vulnerabilities and implement secure patterns |
| **web3-testing** | Test smart contracts using Hardhat and Foundry with unit tests and mainnet forking |

### CI/CD Automation (4 skills)

| Skill | Description |
|-------|-------------|
| **deployment-pipeline-design** | Design multi-stage CI/CD pipelines with approval gates and security checks |
| **github-actions-templates** | Create production-ready GitHub Actions workflows for testing, building, and deploying |
| **gitlab-ci-patterns** | Build GitLab CI/CD pipelines with multi-stage workflows and distributed runners |
| **secrets-management** | Implement secure secrets management using Vault, AWS Secrets Manager, or native solutions |

### Cloud Infrastructure (8 skills)

| Skill | Description |
|-------|-------------|
| **terraform-module-library** | Build reusable Terraform modules for AWS, Azure, and GCP infrastructure |
| **multi-cloud-architecture** | Design multi-cloud architectures avoiding vendor lock-in |
| **hybrid-cloud-networking** | Configure secure connectivity between on-premises and cloud platforms |
| **cost-optimization** | Optimize cloud costs through rightsizing, tagging, and reserved instances |
| **istio-traffic-management** | Configure Istio traffic routing, load balancing, and canary deployments |
| **linkerd-patterns** | Implement Linkerd service mesh with automatic mTLS and traffic splitting |
| **mtls-configuration** | Design zero-trust mTLS architectures with certificate management |
| **service-mesh-observability** | Build comprehensive observability with distributed tracing and metrics |

### Framework Migration (4 skills)

| Skill | Description |
|-------|-------------|
| **react-modernization** | Upgrade React apps, migrate to hooks, and adopt concurrent features |
| **angular-migration** | Migrate from AngularJS to Angular using hybrid mode and incremental rewriting |
| **database-migration** | Execute database migrations with zero-downtime strategies and transformations |
| **dependency-upgrade** | Manage major dependency upgrades with compatibility analysis and testing |

### Observability & Monitoring (4 skills)

| Skill | Description |
|-------|-------------|
| **prometheus-configuration** | Set up Prometheus for comprehensive metric collection and monitoring |
| **grafana-dashboards** | Create production Grafana dashboards for real-time system visualization |
| **distributed-tracing** | Implement distributed tracing with Jaeger and Tempo to track requests |
| **slo-implementation** | Define SLIs and SLOs with error budgets and alerting |

### Payment Processing (4 skills)

| Skill | Description |
|-------|-------------|
| **stripe-integration** | Implement Stripe payment processing for checkout, subscriptions, and webhooks |
| **paypal-integration** | Integrate PayPal payment processing with express checkout and subscriptions |
| **pci-compliance** | Implement PCI DSS compliance for secure payment card data handling |
| **billing-automation** | Build automated billing systems for recurring payments and invoicing |

### Python Development (5 skills)

| Skill | Description |
|-------|-------------|
| **async-python-patterns** | Master Python asyncio, concurrent programming, and async/await patterns |
| **python-testing-patterns** | Implement comprehensive testing with pytest, fixtures, and mocking |
| **python-packaging** | Create distributable Python packages with proper structure and PyPI publishing |
| **python-performance-optimization** | Profile and optimize Python code using cProfile and performance best practices |
| **uv-package-manager** | Master the uv package manager for fast dependency management and virtual environments |

### JavaScript/TypeScript (4 skills)

| Skill | Description |
|-------|-------------|
| **typescript-advanced-types** | Master TypeScript's advanced type system including generics and conditional types |
| **nodejs-backend-patterns** | Build production-ready Node.js services with Express/Fastify and best practices |
| **javascript-testing-patterns** | Implement comprehensive testing with Jest, Vitest, and Testing Library |
| **modern-javascript-patterns** | Master ES6+ features including async/await, destructuring, and functional programming |

### API Scaffolding (1 skill)

| Skill | Description |
|-------|-------------|
| **fastapi-templates** | Create production-ready FastAPI projects with async patterns and error handling |

### Machine Learning Operations (1 skill)

| Skill | Description |
|-------|-------------|
| **ml-pipeline-workflow** | Build end-to-end MLOps pipelines from data preparation through deployment |

### Security Scanning (5 skills)

| Skill | Description |
|-------|-------------|
| **sast-configuration** | Configure Static Application Security Testing tools for vulnerability detection |
| **stride-analysis-patterns** | Apply STRIDE methodology to identify spoofing, tampering, and other threats |
| **attack-tree-construction** | Build attack trees mapping threat scenarios to vulnerabilities |
| **security-requirement-extraction** | Derive security requirements from threat models with acceptance criteria |
| **threat-mitigation-mapping** | Map threats to mitigations with prioritized remediation plans |

### Accessibility Compliance (2 skills)

| Skill | Description |
|-------|-------------|
| **wcag-audit-patterns** | Conduct WCAG 2.2 accessibility audits with automated and manual testing |
| **screen-reader-testing** | Test screen reader compatibility across NVDA, JAWS, and VoiceOver |

### Business Analytics (2 skills)

| Skill | Description |
|-------|-------------|
| **kpi-dashboard-design** | Design executive dashboards with actionable KPIs and drill-down capabilities |
| **data-storytelling** | Transform data insights into compelling narratives for stakeholders |

### Data Engineering (4 skills)

| Skill | Description |
|-------|-------------|
| **spark-optimization** | Optimize Apache Spark jobs with partitioning, caching, and broadcast joins |
| **dbt-transformation-patterns** | Build dbt models with incremental strategies and testing |
| **airflow-dag-patterns** | Design Airflow DAGs with proper dependencies and error handling |
| **data-quality-frameworks** | Implement data quality checks with Great Expectations and custom validators |

### Documentation Generation (3 skills)

| Skill | Description |
|-------|-------------|
| **openapi-spec-generation** | Generate OpenAPI 3.1 specifications from code with complete schemas |
| **changelog-automation** | Automate changelog generation from conventional commits |
| **architecture-decision-records** | Write ADRs documenting architectural decisions and trade-offs |

### Frontend Mobile Development (4 skills)

| Skill | Description |
|-------|-------------|
| **react-state-management** | Implement state management with Zustand, Jotai, and React Query |
| **nextjs-app-router-patterns** | Build Next.js 14+ apps with App Router, RSC, and streaming |
| **tailwind-design-system** | Create design systems with Tailwind CSS and component libraries |
| **react-native-architecture** | Architect React Native apps with navigation and native modules |

### Game Development (2 skills)

| Skill | Description |
|-------|-------------|
| **unity-ecs-patterns** | Implement Unity ECS for high-performance game systems |
| **godot-gdscript-patterns** | Build Godot games with GDScript best practices and scene composition |

### HR Legal Compliance (2 skills)

| Skill | Description |
|-------|-------------|
| **gdpr-data-handling** | Implement GDPR-compliant data processing with consent management |
| **employment-contract-templates** | Generate employment contracts with jurisdiction-specific clauses |

### Incident Response (3 skills)

| Skill | Description |
|-------|-------------|
| **postmortem-writing** | Write blameless postmortems with root cause analysis and action items |
| **incident-runbook-templates** | Create runbooks for common incident scenarios with escalation paths |
| **on-call-handoff-patterns** | Design on-call handoffs with context preservation and alert routing |

### Quantitative Trading (2 skills)

| Skill | Description |
|-------|-------------|
| **backtesting-frameworks** | Build backtesting systems with realistic slippage and transaction costs |
| **risk-metrics-calculation** | Calculate VaR, Sharpe ratio, and drawdown metrics for portfolios |

### Systems Programming (3 skills)

| Skill | Description |
|-------|-------------|
| **rust-async-patterns** | Implement async Rust with Tokio, futures, and proper error handling |
| **go-concurrency-patterns** | Design Go concurrency with channels, worker pools, and context cancellation |
| **memory-safety-patterns** | Write memory-safe code with ownership, bounds checking, and sanitizers |

## How Skills Work

### Activation

Skills are automatically activated when Claude detects matching patterns in your request:

```
User: "Set up Kubernetes deployment with Helm chart"
→ Activates: helm-chart-scaffolding, k8s-manifest-generator

User: "Build a RAG system for document Q&A"
→ Activates: rag-implementation, prompt-engineering-patterns

User: "Optimize Python async performance"
→ Activates: async-python-patterns, python-performance-optimization
```

### Progressive Disclosure

Skills use a three-tier architecture for token efficiency:

1. **Metadata** (Frontmatter): Name and activation criteria (always loaded)
2. **Instructions**: Core guidance and patterns (loaded when activated)
3. **Resources**: Examples and templates (loaded on demand)

### Integration with Agents

Skills work alongside agents to provide deep domain expertise:

- **Agents**: High-level reasoning and orchestration
- **Skills**: Specialized knowledge and implementation patterns

Example workflow:
```
backend-architect agent → Plans API architecture
  ↓
api-design-principles skill → Provides REST/GraphQL best practices
  ↓
fastapi-templates skill → Supplies production-ready templates
```

## Specification Compliance

All 107 skills follow the [Agent Skills Specification](https://github.com/anthropics/skills/blob/main/agent_skills_spec.md):

- ✓ Required `name` field (hyphen-case)
- ✓ Required `description` field with "Use when" clause
- ✓ Descriptions under 1024 characters
- ✓ Complete, non-truncated descriptions
- ✓ Proper YAML frontmatter formatting

## Creating New Skills

To add a skill to a plugin:

1. Create `plugins/{plugin-name}/skills/{skill-name}/SKILL.md`
2. Add YAML frontmatter:
   ```yaml
   ---
   name: skill-name
   description: What the skill does. Use when [activation trigger].
   ---
   ```
3. Write comprehensive skill content using progressive disclosure
4. Add skill path to `marketplace.json`:
   ```json
   {
     "name": "plugin-name",
     "skills": ["./skills/skill-name"]
   }
   ```

### Skill Structure

```
plugins/{plugin-name}/
└── skills/
    └── {skill-name}/
        └── SKILL.md        # Frontmatter + content
```

## Benefits

- **Token Efficiency**: Load only relevant knowledge when needed
- **Specialized Expertise**: Deep domain knowledge without bloat
- **Clear Activation**: Explicit triggers prevent unwanted invocation
- **Composability**: Mix and match skills across workflows
- **Maintainability**: Isolated updates don't affect other skills

## Resources

- [Anthropic Skills Repository](https://github.com/anthropics/skills)
- [Agent Skills Documentation](https://docs.claude.com/en/docs/claude-code/skills)