# Agents Catalog

Complete reference for all available agents in the Task tool.

**Note:** Language and framework domains (Python, JavaScript, TypeScript, Go, Rust, React, Vue, Laravel, Astro, SQL, PostgreSQL) are covered by `-ops` skills, not agents — see `skills-catalog.md`. When subagent work is needed in those domains, dispatch `general-purpose` with an instruction to first read the relevant skill's SKILL.md and references (skill preloading).

**Skills-first domains:** Cloudflare/Workers, Cypress/E2E, shell scripting, AWS ECS/Fargate containers, and Claude Code extension work are now covered by `-ops` skills rather than dedicated agents:

| Former agent | Now use |
|--------------|---------|
| `cloudflare-expert`, `wrangler-expert` | `cloudflare-ops` skill |
| `cypress-expert` | `cypress-ops` skill |
| `bash-expert` | `bash-ops` skill |
| `aws-fargate-ecs-expert` | `container-orchestration` skill |
| `claude-architect` | `claude-code-ops` skill |
| `craftcms-expert` | `craftcms-ops` skill |
| `payloadcms-expert` | `payloadcms-ops` skill |
| `asus-router-expert` | `asus-router-ops` skill |

For these, invoke the skill directly, or dispatch `general-purpose` with an instruction to read the skill's SKILL.md first.

## Specialized Experts

### firecrawl-expert

**Triggers:** firecrawl, web scraping, crawl, anti-bot

**Capabilities:**
- Web scraping strategies
- Anti-bot bypass
- Dynamic content handling
- Structured data extraction
- API integration

**Best For:**
- Complex scraping tasks
- Blocked site access
- Data extraction pipelines
- Crawl architecture

---

### git-agent

**Triggers:** commit, push, PR, branch, rebase (dispatched by git-ops)

**Capabilities:**
- Background git write operations
- Commit and PR creation
- Branch and worktree management
- Safety-tiered execution

**Best For:**
- Dispatched git work from the git-ops skill
- Background commits and pushes

---

### project-organizer

**Triggers:** restructure, organize, cleanup, directory

**Capabilities:**
- Project structure analysis
- Directory reorganization
- Old file cleanup
- Git-aware operations
- Best practice structure

**Best For:**
- Project restructuring
- Codebase cleanup
- Structure standardization
- Tech debt reduction

---

## Built-in Agents

### Explore

**Triggers:** where is, find, locate, codebase search

**Capabilities:**
- Fast codebase exploration
- Pattern matching
- File discovery
- Quick answers

**Best For:**
- "Where is X defined?"
- "Find files matching Y"
- Quick codebase questions

---

### Plan

**Triggers:** plan, design, architect, strategy

**Capabilities:**
- Implementation planning
- Architecture design
- File identification
- Trade-off analysis

**Best For:**
- Feature planning
- Architectural decisions
- Implementation strategy

---

### general-purpose

**Triggers:** multi-step, complex, research

**Capabilities:**
- Autonomous research
- Multi-step tasks
- Code search
- Tool coordination

**Best For:**
- Complex investigations
- Open-ended research
- Multi-step operations

---

### claude-code-guide

**Triggers:** how to use claude code, can claude code, does claude code

**Capabilities:**
- Claude Code documentation
- Feature explanations
- Hook configuration
- MCP server setup
- Agent SDK guidance

**Best For:**
- Claude Code questions
- Configuration help
- Feature discovery
- SDK usage

---

## Selection Guide

| Need | First Try | Then Try |
|------|-----------|----------|
| "How to write X in Python" | python-* skill (e.g. python-pytest-ops) | general-purpose + skill preload |
| "Optimize this query" | postgres-ops skill | general-purpose + skill preload |
| "Find where X is defined" | Explore | general-purpose |
| "Plan feature implementation" | Plan | general-purpose |
| "Scrape this website" | firecrawl-expert | - |
| "Deploy to Cloudflare" | cloudflare-ops skill | general-purpose + skill preload |
| "Fix React performance" | react-ops skill | general-purpose + skill preload |
| "Write E2E tests" | cypress-ops skill | general-purpose + skill preload |
| "Restructure project" | project-organizer | - |
| "Go concurrency design" | go-ops skill | general-purpose + skill preload |
| "Rust lifetime issues" | rust-ops skill | general-purpose + skill preload |
| "Build a Claude Code skill" | claude-code-ops skill | general-purpose + skill preload |

# 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" → general-purpose agent preloading auth-ops + the relevant framework `-ops` skill