skills-catalog.md 19 KB

Skills Catalog

Complete reference for all available skills.

Language & Framework Skills

Comprehensive operational expertise for specific languages and frameworks.

go-ops

Triggers: golang, go, goroutine, channel, context, errgroup, go test, go mod, interface, generics, go build, worker pool

Use For:

  • Concurrency patterns (goroutines, channels, errgroup, worker pools)
  • Error handling (sentinel errors, custom types, wrapping, errors.Is/As)
  • Testing (table-driven, httptest, benchmarks, fuzz, mocking with interfaces)
  • Interface design, generics, functional options
  • Project structure, module management, workspaces
  • Performance profiling (pprof, trace, escape analysis)

References: concurrency.md, error-handling.md, testing.md, interfaces-generics.md, project-structure.md, performance.md


rust-ops

Triggers: rust, cargo, ownership, borrow checker, lifetime, tokio, serde, trait, Result, Option, async rust, crate

Use For:

  • Ownership, borrowing, lifetimes, interior mutability
  • Traits, generics, associated types, derive macros
  • Error handling (thiserror, anyhow, Result/Option combinators)
  • Async with tokio (spawn, channels, select, graceful shutdown)
  • Ecosystem (serde, clap, reqwest, sqlx, axum, tracing, rayon)
  • Testing (mockall, proptest, criterion, insta)

References: ownership-lifetimes.md, traits-generics.md, error-handling.md, async-tokio.md, ecosystem.md, testing.md


typescript-ops

Triggers: typescript, type system, generics, utility types, Zod, mapped types, conditional types, tsconfig, strict mode

Use For:

  • Type narrowing, type guards, discriminated unions
  • Generics, conditional types, mapped types, template literal types
  • Utility types (Partial, Pick, Omit, Record, ReturnType, etc.)
  • tsconfig configuration, strict mode migration
  • Runtime validation (Zod, Valibot), type-safe APIs (tRPC)

References: type-system.md, generics-patterns.md, utility-types.md, config-strict.md, ecosystem.md


Infrastructure Skills

docker-ops

Triggers: docker, Dockerfile, docker-compose, container, image, multi-stage build, distroless, BuildKit

Use For:

  • Dockerfile best practices, multi-stage builds (Go, Rust, Node, Python)
  • Docker Compose patterns (services, volumes, networking, health checks)
  • Image optimization, layer caching, security scanning
  • BuildKit features, cross-platform builds

References: multi-stage-builds.md, compose-patterns.md, optimization.md


ci-cd-ops

Triggers: github actions, CI, CD, pipeline, workflow, release, semantic release, changesets, goreleaser

Use For:

  • GitHub Actions workflow syntax, triggers, matrix strategy
  • Caching strategies (node_modules, go modules, cargo, pip)
  • Release automation (semantic-release, changesets, goreleaser)
  • Testing pipelines, code coverage, deployment gates

References: github-actions.md, release-automation.md, testing-pipelines.md


api-design-ops

Triggers: api design, gRPC, GraphQL, protobuf, api versioning, pagination, rate limiting, webhook, idempotency

Use For:

  • API style selection (REST vs gRPC vs GraphQL)
  • REST advanced patterns (pagination, PATCH, bulk ops, webhooks)
  • gRPC (protobuf, streaming, Go/Rust implementations)
  • GraphQL (schema design, DataLoader, federation)
  • API security (JWT, OAuth2, rate limiting, OWASP API Top 10)

References: rest-advanced.md, grpc.md, graphql.md, api-security.md


Pattern Skills

Quick reference for common patterns and syntax.

rest-ops

Triggers: rest api, http methods, status codes, api design, endpoint design

Use For:

  • HTTP method semantics (GET, POST, PUT, PATCH, DELETE)
  • Status code selection
  • API versioning strategies
  • Caching and rate limiting
  • Error response formats

References: status-codes.md, caching-patterns.md, rate-limiting.md, response-formats.md


postgres-ops

Triggers: postgresql, postgres, EXPLAIN ANALYZE, vacuum, autovacuum, pgbouncer, JSONB, RLS, replication, partitioning, pg_stat, GIN, GiST, BRIN, tsvector, WAL, connection pooling, postgresql.conf

Use For:

  • Schema design, normalization, data types (JSONB, arrays, ranges)
  • Index selection (B-tree, GIN, GiST, BRIN, Hash)
  • Query tuning with EXPLAIN ANALYZE
  • Backup/restore (pg_dump, pg_basebackup, WAL, PITR)
  • Vacuum and autovacuum tuning
  • Connection pooling (pgBouncer, pgPool)
  • Replication (streaming, logical), failover
  • Partitioning (range, list, hash)
  • Monitoring (pg_stat_statements, bloat, locks)
  • Row-level security, full-text search, extensions

References: schema-design.md, indexing.md, query-tuning.md, operations.md, replication.md, config-tuning.md


sql-ops

Triggers: sql patterns, cte example, window functions, sql join, index strategy

Use For:

  • CTE (Common Table Expressions)
  • Window functions (ROW_NUMBER, LAG, running totals)
  • JOIN reference
  • Pagination patterns
  • Vendor-neutral index strategies

References: window-functions.md, indexing-strategies.md


tailwind-ops

Triggers: tailwind, utility classes, responsive design, tailwind config, dark mode

Use For:

  • Responsive breakpoints
  • Layout patterns (flex, grid)
  • Component patterns (cards, forms, navbars)
  • Dark mode configuration
  • State modifiers

References: component-patterns.md


sqlite-ops

Triggers: sqlite, sqlite3, aiosqlite, local database, database schema

Use For:

  • Schema design patterns (state, cache, events)
  • Python sqlite3 usage
  • Async operations with aiosqlite
  • WAL mode configuration
  • Migration patterns

References: schema-patterns.md, async-patterns.md, migration-patterns.md


react-ops

Triggers: react, hooks, useState, useEffect, jsx, tsx, next.js, nextjs, app router, server components, RSC, zustand, react query

Use For:

  • Hook patterns (built-in, custom, React 19)
  • Component architecture (compound, render props, HOCs)
  • State management (Context, Zustand, Jotai, Redux Toolkit, TanStack Query)
  • React Server Components, Server Actions, streaming
  • Performance optimization (memo, code splitting, virtualization)
  • Testing (React Testing Library, MSW, Vitest)

References: hooks-patterns.md, component-architecture.md, state-management.md, server-components.md, performance.md, testing.md


vue-ops

Triggers: vue, vuejs, composition api, pinia, vue router, nuxt, nuxt3, script setup, composable, reactive, defineProps

Use For:

  • Composition API and composables
  • Pinia state management
  • Vue Router (guards, lazy loading, meta)
  • Nuxt 3 (SSR/SSG, useFetch, server routes, modules)
  • Testing (Vitest, Vue Test Utils, Pinia testing)

References: composition-api.md, state-routing.md, nuxt.md, testing.md


javascript-ops

Triggers: javascript, js, node, nodejs, esm, commonjs, promise, async await, event loop, v8, npm, es2024

Use For:

  • Async patterns (Promises, async/await, streams, workers)
  • Module systems (ESM, CJS, dual-package)
  • Modern JS features (ES2022-2025)
  • Node.js patterns (built-in test runner, worker_threads, streams)
  • V8 optimization and memory management

References: async-patterns.md, modules-runtime.md, modern-features.md, node-patterns.md


astro-ops

Triggers: astro, islands architecture, content collections, astro cloudflare, view transitions, partial hydration

Use For:

  • Rendering strategies (SSG, SSR, hybrid)
  • Islands architecture and partial hydration
  • Content Collections (schema, queries, MDX)
  • Deployment (Cloudflare, Vercel, Netlify, Node)

References: content-collections.md, islands-rendering.md, deployment.md


laravel-ops

Triggers: laravel, eloquent, artisan, blade, php, sanctum, livewire, inertia, pest, phpunit

Use For:

  • Eloquent ORM (relationships, scopes, query optimization)
  • Architecture (Service Container, providers, facades, middleware)
  • Authentication (Sanctum, Fortify, policies/gates)
  • Testing (Pest, PHPUnit, factories, facade fakes)

References: eloquent-queries.md, architecture.md, testing-auth.md


mcp-ops

Triggers: mcp, model context protocol, mcp server, mcp tool, mcp resource, fastmcp, mcp transport, stdio, sse

Use For:

  • MCP server development (Python FastMCP, TypeScript SDK)
  • Tool design (schema, validation, error handling)
  • Resources and prompts
  • Transport configuration (stdio, SSE, streamable HTTP)
  • Authentication and session management
  • Testing and debugging (MCP Inspector)

References: server-architecture.md, tool-handlers.md, resources-prompts.md, transport-auth.md, testing-debugging.md


tailwind-ops

Triggers: tailwind, tailwindcss, utility classes, responsive design, dark mode, tailwind v4, container queries

Use For:

  • Layout patterns (flex, grid, container queries)
  • Responsive design and dark mode
  • Component patterns (cards, forms, navbars, modals)
  • Tailwind v4 migration (CSS-first config, @theme)
  • Configuration and plugins

References: component-patterns.md, v4-migration.md, configuration.md


Infrastructure & Operations Skills

nginx-ops

Triggers: nginx, reverse proxy, load balancer, proxy_pass, ssl certificate, lets encrypt, web server

Use For:

  • Reverse proxy configuration and load balancing
  • SSL/TLS setup (Let's Encrypt, HSTS, OCSP)
  • Security headers and rate limiting
  • Performance tuning (gzip, caching, worker config)
  • Docker patterns (nginx as sidecar)

References: reverse-proxy.md, ssl-security.md, performance.md


auth-ops

Triggers: authentication, authorization, jwt, oauth, oauth2, session, login, rbac, abac, passkey, mfa, api key

Use For:

  • Authentication methods (JWT, sessions, OAuth2, passkeys)
  • Authorization models (RBAC, ABAC, ReBAC)
  • OAuth2/OIDC flows (Authorization Code + PKCE, Client Credentials)
  • Password handling, MFA, session management
  • Implementation patterns across Node.js, Python, Go

References: jwt-sessions.md, oauth2-oidc.md, authorization.md, implementation.md


monitoring-ops

Triggers: monitoring, observability, prometheus, grafana, metrics, alerting, opentelemetry, SLO, distributed tracing

Use For:

  • Metrics (Prometheus, PromQL, OpenTelemetry)
  • Structured logging (Loki, ELK, language-specific)
  • Distributed tracing (OpenTelemetry, Jaeger)
  • Alerting and SLO/SLI design
  • Infrastructure monitoring and health checks

References: metrics-alerting.md, logging.md, tracing.md, infrastructure.md


debug-ops

Triggers: debug, debugging, bug, crash, memory leak, race condition, deadlock, bisect, root cause, profiling

Use For:

  • Systematic debugging methodology
  • Language-specific debugger usage (Node, Python, Go, Rust)
  • Common scenarios (memory leaks, deadlocks, race conditions)
  • Root cause analysis and reproduction techniques

References: systematic-methods.md, tool-specific.md, common-scenarios.md


CLI Tool Skills

Modern command-line tools for development workflows.

file-search

Triggers: fd, ripgrep, rg, find files, search code, fzf, fuzzy find

Use For:

  • Finding files by name (fd)
  • Searching file contents (rg)
  • Interactive selection (fzf)
  • Combined workflows

References: advanced-workflows.md


find-replace

Triggers: sd, find replace, batch replace, string replacement

Use For:

  • Modern find-and-replace with sd
  • Regex patterns
  • Batch operations
  • Preview before applying

References: advanced-patterns.md


code-stats

Triggers: tokei, difft, line counts, code statistics, semantic diff

Use For:

  • Codebase statistics (tokei)
  • Semantic diffs (difft)
  • Language breakdown
  • Before/after comparisons

References: tokei-advanced.md, difft-advanced.md


data-processing

Triggers: jq, yq, json, yaml, toml

Use For:

  • JSON processing and transformation
  • YAML/TOML operations
  • Structured data queries
  • Config file manipulation

References: jq-patterns.md, yq-patterns.md, shell-integration.md


structural-search

Triggers: ast-grep, sg, ast pattern, find function calls, semantic search

Use For:

  • Search by AST structure
  • Pattern matching in code
  • Refactoring operations
  • Security scans

References: js-ts-patterns.md, python-patterns.md, go-rust-patterns.md, security-ops.md, advanced-usage.md


Workflow Skills

Project and development workflow automation.

git-ops

Triggers: commit, push, pull request, create PR, git status, git diff, rebase, stash, branch, merge, release, tag, changelog, semver, cherry-pick, bisect, worktree, lazygit, gh, delta

Use For:

  • Commit, push, and branch management (dispatched to background Sonnet agent)
  • PR creation with contextual titles and descriptions
  • Release workflows - tagging, GitHub releases, changelog generation
  • Semantic versioning analysis from Conventional Commits
  • Interactive git operations (lazygit)
  • GitHub CLI (gh) commands
  • Safety-tiered operations (read-only inline, safe writes dispatched, destructive with preflight)

Agent: git-agent (model: sonnet, background)

References: rebase-patterns.md, stash-patterns.md, advanced-git.md


python-env

Triggers: uv, venv, pip, pyproject, python environment

Use For:

  • Fast environment setup with uv
  • Virtual environment creation
  • Dependency management
  • pyproject.toml configuration

References: pyproject-patterns.md, dependency-management.md


task-runner

Triggers: just, justfile, run tests, build project, list tasks

Use For:

  • Project task execution
  • Justfile configuration
  • Common development commands

doc-scanner

Triggers: AGENTS.md, conventions, scan docs, project documentation

Use For:

  • Finding project documentation
  • Synthesizing AI agent instructions
  • Consolidating multiple doc files
  • Creating AGENTS.md

References: file-patterns.md, templates.md


project-planner

Triggers: plan, sync plan, track, project planning

Use For:

  • Session state with /save and /sync
  • Progress tracking
  • Context preservation

Selection Guide

By File Type

Working With Skill
JSON files data-processing
YAML/TOML data-processing
SQL databases sql-ops, postgres-ops, sqlite-ops
Go go-ops
Rust rust-ops
TypeScript/JS typescript-ops, javascript-ops, file-search, structural-search
React/Next.js react-ops, typescript-ops
Vue/Nuxt vue-ops, typescript-ops
Astro astro-ops, typescript-ops
PHP/Laravel laravel-ops
Python python-env, structural-search
API design api-design-ops, rest-ops
Docker/containers docker-ops, container-orchestration
CI/CD ci-cd-ops, git-ops
CSS/Tailwind tailwind-ops
Nginx/web server nginx-ops
Auth/security auth-ops, security-ops
Monitoring monitoring-ops, python-observability-ops

By Task

Task Skill
Find files by name file-search
Search code content file-search
Replace across files find-replace
Count lines of code code-stats
Compare code changes code-stats
Process JSON/YAML data-processing
Git operations git-ops
Set up Python project python-env
Run project tasks task-runner
Find project docs doc-scanner
Plan implementation project-planner
Debug a crash/leak debug-ops
Configure nginx nginx-ops
Set up auth auth-ops
Add monitoring monitoring-ops

By Complexity

Quick Lookups (< 1 min):

  • rest-ops: Status code lookup
  • sql-ops: CTE syntax
  • tailwind-ops: Breakpoint reference
  • file-search: Basic fd/rg commands

Medium Tasks (1-5 min):

  • find-replace: Batch replacements
  • data-processing: JSON transformations
  • git-ops: Rebase, PR creation, release workflows
  • python-env: Project setup

Complex Workflows (5+ min):

  • structural-search: Security scans
  • doc-scanner: Documentation consolidation
  • project-planner: Session planning
  • migrate-ops: Framework version upgrades
  • refactor-ops: Large-scale refactoring

migrate-ops

Triggers: migrate, upgrade, migration, version upgrade, breaking changes, codemod, rector, jscodeshift, framework upgrade, dependency audit

Use For:

  • Framework version upgrades (React 18→19, Vue 2→3, Next.js Pages→App Router, Laravel 10→11)
  • Language upgrades (Python 3.9→3.13, Node 18→22, TypeScript 4→5, Go, Rust editions)
  • Dependency audit and upgrade workflows (npm audit, pip-audit, cargo audit, govulncheck)
  • Breaking change detection and codemod application
  • Rollback strategies and pre-migration checklists

References: framework-upgrades.md, language-upgrades.md, dependency-management.md


refactor-ops

Triggers: refactor, extract function, extract component, code smell, dead code, rename, restructure, technical debt, cyclomatic complexity

Use For:

  • Extract patterns (function, component, hook, module, class, configuration)
  • Code smell detection (long functions, god objects, feature envy, duplicate code)
  • Dead code detection and removal workflows
  • Test-driven refactoring methodology (characterization tests, strangler fig)
  • Safe rename and move operations across codebase

References: extract-patterns.md, code-smells.md, safe-methodology.md


scaffold

Triggers: scaffold, boilerplate, project template, init project, create project, starter, new project, setup project

Use For:

  • API project scaffolding (FastAPI, Express, Gin, Axum)
  • Web app scaffolding (Next.js, Nuxt, Astro, SvelteKit)
  • CLI tool scaffolding (Typer, Commander, Cobra, Clap)
  • Library/package scaffolding (npm, PyPI, crate, Go module)
  • Monorepo scaffolding (Turborepo, Nx, workspaces)
  • Common additions (CI/CD, Docker, linting, pre-commit)

References: api-templates.md, frontend-templates.md, tooling-templates.md


perf-ops

Triggers: performance, profiling, flamegraph, memory leak, bundle size, load test, benchmark, slow, latency, optimization, pprof, py-spy, clinic.js

Use For:

  • CPU profiling (flamegraphs, pprof, py-spy, clinic.js, samply)
  • Memory profiling (heaptrack, memray, Chrome DevTools, Valgrind)
  • Bundle analysis (webpack-bundle-analyzer, source-map-explorer)
  • Load testing (k6, artillery, vegeta, locust)
  • Benchmarking (hyperfine, criterion, pytest-benchmark, vitest bench)
  • Optimization patterns (caching, lazy loading, connection pooling)

References: cpu-memory-profiling.md, load-testing.md, optimization-patterns.md


log-ops

Triggers: log analysis, JSONL, log file, parse logs, search logs, lnav, jq logs, structured logs, log aggregation, timeline reconstruction, cross-log correlation

Use For:

  • JSONL streaming extraction and aggregation with jq
  • Two-stage rg+jq pipelines for large log files
  • Timeline reconstruction from log timestamps
  • Cross-log correlation across multiple files
  • Agent conversation log analysis (tool calls, errors, phases)
  • Cross-directory log searching (fd + rg + jq composition)
  • Interactive log exploration with lnav

References: jsonl-patterns.md, analysis-workflows.md, tool-setup.md


When to Use Skills vs Agents

Use a Skill when:

  • You need quick reference (syntax, patterns)
  • Task is well-defined (replace X with Y)
  • Looking up how to do something
  • Executing a known workflow

Use an Agent when:

  • Requires reasoning or decisions
  • Complex problem-solving needed
  • Multiple approaches to evaluate
  • Architecture or optimization

Example:

  • "What's the HTTP status for unauthorized?" → rest-ops (skill)
  • "Design authentication for my API" → python-expert or relevant framework agent