Back to Agents

Agent Skills

docs/agent-skills.md

latest24.0 KB
Original Source

Agent Skills

Agent Skills are modular packages that extend Claude's capabilities with specialized domain knowledge, following Anthropic's Agent Skills Specification. This plugin ecosystem includes 129 specialized skills across 27 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)

SkillDescription
k8s-manifest-generatorCreate production-ready Kubernetes manifests for Deployments, Services, ConfigMaps, and Secrets following best practices
helm-chart-scaffoldingDesign, organize, and manage Helm charts for templating and packaging Kubernetes applications
gitops-workflowImplement GitOps workflows with ArgoCD and Flux for automated, declarative deployments
k8s-security-policiesImplement Kubernetes security policies including NetworkPolicy, PodSecurityPolicy, and RBAC

LLM Application Development (8 skills)

SkillDescription
langchain-architectureDesign LLM applications using LangChain framework with agents, memory, and tool integration
prompt-engineering-patternsMaster advanced prompt engineering techniques for LLM performance and reliability
rag-implementationBuild Retrieval-Augmented Generation systems with vector databases and semantic search
llm-evaluationImplement comprehensive evaluation strategies with automated metrics and benchmarking
embedding-strategiesDesign embedding pipelines for text, images, and multimodal content with optimal chunking
similarity-search-patternsImplement efficient similarity search with ANN algorithms and distance metrics
vector-index-tuningOptimize vector index performance with HNSW, IVF, and hybrid configurations
hybrid-search-implementationCombine vector and keyword search for improved retrieval accuracy

Backend Development (9 skills)

SkillDescription
api-design-principlesMaster REST and GraphQL API design for intuitive, scalable, and maintainable APIs
architecture-patternsImplement Clean Architecture, Hexagonal Architecture, and Domain-Driven Design
microservices-patternsDesign microservices with service boundaries, event-driven communication, and resilience
workflow-orchestration-patternsDesign durable workflows with Temporal for distributed systems, saga patterns, and state management
temporal-python-testingTest Temporal workflows with pytest, time-skipping, and mocking strategies for comprehensive coverage
event-store-designDesign event stores with optimized schemas, snapshots, and stream partitioning
cqrs-implementationImplement CQRS with separate read/write models and eventual consistency patterns
projection-patternsBuild efficient projections from event streams for read-optimized views
saga-orchestrationDesign distributed sagas with compensation logic and failure handling

Developer Essentials (11 skills)

SkillDescription
git-advanced-workflowsMaster advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog
sql-optimization-patternsOptimize SQL queries, indexing strategies, and EXPLAIN analysis for database performance
error-handling-patternsImplement robust error handling with exceptions, Result types, and graceful degradation
code-review-excellenceProvide effective code reviews with constructive feedback and systematic analysis
e2e-testing-patternsBuild reliable E2E test suites with Playwright and Cypress for critical user workflows
auth-implementation-patternsImplement authentication and authorization with JWT, OAuth2, sessions, and RBAC
debugging-strategiesMaster systematic debugging techniques, profiling tools, and root cause analysis
monorepo-managementManage monorepos with Turborepo, Nx, and pnpm workspaces for scalable multi-package projects
nx-workspace-patternsConfigure Nx workspaces with computation caching and affected commands
turborepo-cachingOptimize Turborepo builds with remote caching and pipeline configuration
bazel-build-optimizationDesign Bazel builds with hermetic actions and remote execution

Blockchain & Web3 (4 skills)

SkillDescription
defi-protocol-templatesImplement DeFi protocols with templates for staking, AMMs, governance, and lending
nft-standardsImplement NFT standards (ERC-721, ERC-1155) with metadata and marketplace integration
solidity-securityMaster smart contract security to prevent vulnerabilities and implement secure patterns
web3-testingTest smart contracts using Hardhat and Foundry with unit tests and mainnet forking

CI/CD Automation (4 skills)

SkillDescription
deployment-pipeline-designDesign multi-stage CI/CD pipelines with approval gates and security checks
github-actions-templatesCreate production-ready GitHub Actions workflows for testing, building, and deploying
gitlab-ci-patternsBuild GitLab CI/CD pipelines with multi-stage workflows and distributed runners
secrets-managementImplement secure secrets management using Vault, AWS Secrets Manager, or native solutions

Cloud Infrastructure (8 skills)

SkillDescription
terraform-module-libraryBuild reusable Terraform modules for AWS, Azure, and GCP infrastructure
multi-cloud-architectureDesign multi-cloud architectures avoiding vendor lock-in
hybrid-cloud-networkingConfigure secure connectivity between on-premises and cloud platforms
cost-optimizationOptimize cloud costs through rightsizing, tagging, and reserved instances
istio-traffic-managementConfigure Istio traffic routing, load balancing, and canary deployments
linkerd-patternsImplement Linkerd service mesh with automatic mTLS and traffic splitting
mtls-configurationDesign zero-trust mTLS architectures with certificate management
service-mesh-observabilityBuild comprehensive observability with distributed tracing and metrics

Framework Migration (4 skills)

SkillDescription
react-modernizationUpgrade React apps, migrate to hooks, and adopt concurrent features
angular-migrationMigrate from AngularJS to Angular using hybrid mode and incremental rewriting
database-migrationExecute database migrations with zero-downtime strategies and transformations
dependency-upgradeManage major dependency upgrades with compatibility analysis and testing

Observability & Monitoring (4 skills)

SkillDescription
prometheus-configurationSet up Prometheus for comprehensive metric collection and monitoring
grafana-dashboardsCreate production Grafana dashboards for real-time system visualization
distributed-tracingImplement distributed tracing with Jaeger and Tempo to track requests
slo-implementationDefine SLIs and SLOs with error budgets and alerting

Payment Processing (4 skills)

SkillDescription
stripe-integrationImplement Stripe payment processing for checkout, subscriptions, and webhooks
paypal-integrationIntegrate PayPal payment processing with express checkout and subscriptions
pci-complianceImplement PCI DSS compliance for secure payment card data handling
billing-automationBuild automated billing systems for recurring payments and invoicing

Python Development (5 skills)

SkillDescription
async-python-patternsMaster Python asyncio, concurrent programming, and async/await patterns
python-testing-patternsImplement comprehensive testing with pytest, fixtures, and mocking
python-packagingCreate distributable Python packages with proper structure and PyPI publishing
python-performance-optimizationProfile and optimize Python code using cProfile and performance best practices
uv-package-managerMaster the uv package manager for fast dependency management and virtual environments

JavaScript/TypeScript (4 skills)

SkillDescription
typescript-advanced-typesMaster TypeScript's advanced type system including generics and conditional types
nodejs-backend-patternsBuild production-ready Node.js services with Express/Fastify and best practices
javascript-testing-patternsImplement comprehensive testing with Jest, Vitest, and Testing Library
modern-javascript-patternsMaster ES6+ features including async/await, destructuring, and functional programming

API Scaffolding (1 skill)

SkillDescription
fastapi-templatesCreate production-ready FastAPI projects with async patterns and error handling

Machine Learning Operations (1 skill)

SkillDescription
ml-pipeline-workflowBuild end-to-end MLOps pipelines from data preparation through deployment

Security Scanning (5 skills)

SkillDescription
sast-configurationConfigure Static Application Security Testing tools for vulnerability detection
stride-analysis-patternsApply STRIDE methodology to identify spoofing, tampering, and other threats
attack-tree-constructionBuild attack trees mapping threat scenarios to vulnerabilities
security-requirement-extractionDerive security requirements from threat models with acceptance criteria
threat-mitigation-mappingMap threats to mitigations with prioritized remediation plans

Accessibility Compliance (2 skills)

SkillDescription
wcag-audit-patternsConduct WCAG 2.2 accessibility audits with automated and manual testing
screen-reader-testingTest screen reader compatibility across NVDA, JAWS, and VoiceOver

Business Analytics (2 skills)

SkillDescription
kpi-dashboard-designDesign executive dashboards with actionable KPIs and drill-down capabilities
data-storytellingTransform data insights into compelling narratives for stakeholders

Data Engineering (4 skills)

SkillDescription
spark-optimizationOptimize Apache Spark jobs with partitioning, caching, and broadcast joins
dbt-transformation-patternsBuild dbt models with incremental strategies and testing
airflow-dag-patternsDesign Airflow DAGs with proper dependencies and error handling
data-quality-frameworksImplement data quality checks with Great Expectations and custom validators

Documentation Generation (3 skills)

SkillDescription
openapi-spec-generationGenerate OpenAPI 3.1 specifications from code with complete schemas
changelog-automationAutomate changelog generation from conventional commits
architecture-decision-recordsWrite ADRs documenting architectural decisions and trade-offs

Frontend Mobile Development (4 skills)

SkillDescription
react-state-managementImplement state management with Zustand, Jotai, and React Query
nextjs-app-router-patternsBuild Next.js 14+ apps with App Router, RSC, and streaming
tailwind-design-systemCreate design systems with Tailwind CSS and component libraries
react-native-architectureArchitect React Native apps with navigation and native modules

UI Design (9 skills)

SkillDescription
design-system-patternsBuild scalable design systems with tokens, components, and theming
accessibility-complianceImplement WCAG 2.1/2.2 compliance with proper ARIA and keyboard nav
responsive-designCreate fluid layouts with CSS Grid, Flexbox, and container queries
mobile-ios-designDesign iOS apps following Human Interface Guidelines
mobile-android-designDesign Android apps following Material Design 3 guidelines
react-native-designCross-platform design patterns for React Native applications
web-component-designBuild accessible, reusable web components with Shadow DOM
interaction-designCreate micro-interactions, animations, and gesture-based interfaces
visual-design-foundationsApply typography, color theory, spacing, and visual hierarchy

Game Development (2 skills)

SkillDescription
unity-ecs-patternsImplement Unity ECS for high-performance game systems
godot-gdscript-patternsBuild Godot games with GDScript best practices and scene composition
SkillDescription
gdpr-data-handlingImplement GDPR-compliant data processing with consent management
employment-contract-templatesGenerate employment contracts with jurisdiction-specific clauses

Incident Response (3 skills)

SkillDescription
postmortem-writingWrite blameless postmortems with root cause analysis and action items
incident-runbook-templatesCreate runbooks for common incident scenarios with escalation paths
on-call-handoff-patternsDesign on-call handoffs with context preservation and alert routing

Quantitative Trading (2 skills)

SkillDescription
backtesting-frameworksBuild backtesting systems with realistic slippage and transaction costs
risk-metrics-calculationCalculate VaR, Sharpe ratio, and drawdown metrics for portfolios

Systems Programming (3 skills)

SkillDescription
rust-async-patternsImplement async Rust with Tokio, futures, and proper error handling
go-concurrency-patternsDesign Go concurrency with channels, worker pools, and context cancellation
memory-safety-patternsWrite memory-safe code with ownership, bounds checking, and sanitizers

Conductor - Project Management (3 skills)

SkillDescription
context-driven-developmentApply Context-Driven Development methodology with product context, specifications, and phased planning
track-managementManage development tracks for features, bugs, chores, and refactors with specs and implementation plans
workflow-patternsImplement TDD workflows, commit strategies, and verification checkpoints for systematic development

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:

  • ✓ 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