## 1. Project Overview & Quickstart (wshobson/agents)

## File: README.md

# Agentic Plugin Marketplace

> Production-ready agentic workflow building blocks: **92 plugins**, **202 agents**,
> **181 skills**, **105 commands** — built for Claude Code and consumed natively by
> OpenAI Codex CLI, Cursor, OpenCode, the Antigravity CLI, and GitHub Copilot from a single Markdown source.

[](#claude-code) [](docs/harnesses.md) [](docs/harnesses.md) [](docs/harnesses.md) [](docs/harnesses.md) [](docs/harnesses.md)

> [!NOTE]
> One source-of-truth (`plugins/`), five harnesses. Each harness gets idiomatic,
> harness-native artifacts — not lowest-common-denominator translations.
> See [docs/harnesses.md](docs/harnesses.md) for the capability matrix.

## Quick start

Pick your harness:

### Claude Code

```bash
/plugin marketplace add wshobson/agents
/plugin install python-development          # or any of 92 plugins
```

[→ Full Claude Code setup, troubleshooting, and plugin catalog](docs/usage.md)

### Codex CLI · Cursor · OpenCode · Antigravity CLI · Copilot

Codex and Cursor install natively from the committed registries (which point at the source `plugins/`):

```bash
npx codex-marketplace add wshobson/agents        # Codex; then install individual plugins
# Cursor: add the marketplace, then `/plugin install <name>` (reads .cursor-plugin/ + source)
```

Antigravity and OpenCode install via clone + generate (the transformed trees are gitignored):

```bash
gh repo clone wshobson/agents ~/agents && cd ~/agents
make generate HARNESS=antigravity && make install-antigravity  # Antigravity (agy)
make install-opencode                                          # OpenCode (runs generate + symlinks)
```

Setup details and per-harness gotchas: [docs/harnesses.md](docs/harnesses.md).

## What's inside

| | Count | What it is |
|---|---:|---|
| **Plugins** | 92 | Granular, single-purpose installable units (91 local + 1 external via git-subdir) |
| **Agents** | 202 | Domain experts (architecture, languages, infra, security, data, ML, docs, business, SEO) |
| **Skills** | 181 | Modular knowledge packages with progressive disclosure (load when activated) |
| **Commands** | 105 | Slash commands: scaffolding, security scans, test gen, infrastructure setup |
| **Orchestrators** | 16 | Multi-agent coordination workflows (full-stack, security, ML, incident response) |

Browse the catalog: [docs/plugins.md](docs/plugins.md) · [docs/agents.md](docs/agents.md) · [docs/agent-skills.md](docs/agent-skills.md)

## How it works

Each plugin is isolated and composable: agents, commands, and skills are auto-discovered
from directory structure. **Installing a plugin loads only its components into
context** — not the whole marketplace.

```
plugins/python-development/
├── .claude-plugin/plugin.json
├── agents/             # 3 Python agents (python-pro, django-pro, fastapi-pro)
├── commands/           # 1 scaffolding command
└── skills/             # 16 specialized skills (async, testing, packaging, …)
```

Tiered model strategy:

| Tier | Model | Use |
|---|---|---|
| 0 | Fable 5  | Longest-horizon autonomous work — large migrations, multi-hour runs (opt-in, premium cost) |
| 1 | Opus     | Architecture, security, code review, production-critical |
| 2 | inherit  | User-chosen — backend, frontend, AI/ML, specialized |
| 3 | Sonnet   | Docs, testing, debugging, API references |
| 4 | Haiku    | Fast operational tasks, SEO, deployment, content |

[→ Model configuration details](docs/agents.md#model-configuration)

## Multi-harness support

This marketplace ships to five agentic harnesses from one Markdown source. Each adapter
emits harness-native artifacts (not lowest-common-denominator translations):

| Harness | Generates | Notes |
|---|---|---|
| **Claude Code** | (source-of-truth) | Native `marketplace.json` + `plugins/` |
| **Codex CLI** | `.agents/plugins/marketplace.json` + `plugins/*/.codex-plugin/plugin.json` (committed); `.codex/skills/`, `.codex/agents/` (gitignored) | 8 KB skill cap respected; commands → skills |
| **Cursor** | `.cursor-plugin/`, `.cursor/rules/` | Thin marketplace + curated rules; reuses `.claude/` |
| **OpenCode** | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | `permission:` block from `tools:` allowlist; OpenCode-safe skill names |
| **Antigravity CLI** | `.antigravity/plugins//{skills/,agents/,commands/}` | Self-contained agy plugin per source plugin; model tier alias (`inherit`/`flash`/`pro`) |
| **Copilot** | `.copilot/agents/`, `.copilot/skills/`, `.copilot/commands/` | Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to native Claude models |

```bash
make generate-all                        # all five
make validate                            # structural checks
make garden                              # drift / dead-link / cap detection
```

Codex and Cursor install from source via committed registries; Antigravity and OpenCode install via clone + `make`.

[→ Full capability matrix and per-harness deep-dives](docs/harnesses.md)

## Quality evaluation

[`plugin-eval`](plugins/plugin-eval/) is a three-layer evaluation framework for measuring
and certifying plugin/skill quality:

- **Static** — deterministic structural analysis (<2s, free)
- **LLM Judge** — semantic evaluation across 4 dimensions (~30s, Haiku + Sonnet)
- **Monte Carlo** — statistical reliability via 50-100 simulated runs (~2-5 min)

```bash
uv run plugin-eval score path/to/skill --depth quick
uv run plugin-eval certify path/to/skill
```

[→ PluginEval framework documentation](docs/plugin-eval.md)

## Documentation map

Detail lives in `docs/`. Read in this order:

- **[docs/plugins.md](docs/plugins.md)** — full catalog of all 92 plugins
- **[docs/agents.md](docs/agents.md)** — all 202 agents by category
- **[docs/agent-skills.md](docs/agent-skills.md)** — 181 skills with progressive disclosure
- **[docs/usage.md](docs/usage.md)** — commands, workflows, examples
- **[docs/architecture.md](docs/architecture.md)** — design principles
- **[docs/harnesses.md](docs/harnesses.md)** — cross-harness capability matrix
- **[docs/authoring.md](docs/authoring.md)** — portable-content style guide
- **[docs/plugin-eval.md](docs/plugin-eval.md)** — quality evaluation framework
- **[docs/round-trip-results.md](docs/round-trip-results.md)** — real-CLI verification recipes

Harness setup, capability deltas, and gotchas live in [docs/harnesses.md](docs/harnesses.md).

Contributing: [CONTRIBUTING.md](CONTRIBUTING.md) · Authoring: [docs/authoring.md](docs/authoring.md)

## External Memory Integration

[Pensyve](https://github.com/major7apps/pensyve) is included as an external
`git-subdir` entry for Claude Code. Pensyve also maintains direct upstream
integrations for Codex CLI, Cursor, OpenCode, and Copilot (not yet Antigravity CLI).

| Harness | Pensyve integration |
|---|---|
| Claude Code | `/plugin install pensyve` from this marketplace (`integrations/claude-code`) |
| Codex CLI | [integrations/codex-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/codex-plugin) |
| Cursor | [integrations/cursor](https://github.com/major7apps/pensyve/tree/main/integrations/cursor) |
| OpenCode | [integrations/opencode-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/opencode-plugin) |
| Copilot | `.copilot/` in repo root or `~/.copilot/` via `make install-copilot` |

## License

MIT — see [LICENSE](LICENSE).

## Star history

[](https://star-history.dera.page/#wshobson/agents&type=date&legend=top-left)

---

## File: 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 **181 local specialized skills** across 50 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 flash loans      |
| **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 (16 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          |

### Before You Build (1 skill)

| Skill                | Description                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **before-you-build** | Review demand, positioning, monetization, retention, trust, distribution, and feature-adoption risk before implementation starts |

### Avoid AI Writing (1 skill)

| Skill                | Description                                                                                                 |
| -------------------- | ----------------------------------------------------------------------------------------------------------- |
| **avoid-ai-writing** | Audit and rewrite prose that reads as machine-generated, with detect-only, rewrite, and edit-in-place modes   |

### 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  |

### UI Design (9 skills)

| Skill                         | Description                                                         |
| ----------------------------- | ------------------------------------------------------------------- |
| **design-system-patterns**    | Build scalable design systems with tokens, components, and theming  |
| **accessibility-compliance**  | Implement WCAG 2.1/2.2 compliance with proper ARIA and keyboard nav |
| **responsive-design**         | Create fluid layouts with CSS Grid, Flexbox, and container queries  |
| **mobile-ios-design**         | Design iOS apps following Human Interface Guidelines                |
| **mobile-android-design**     | Design Android apps following Material Design 3 guidelines          |
| **react-native-design**       | Cross-platform design patterns for React Native applications        |
| **web-component-design**      | Build accessible, reusable web components with Shadow DOM           |
| **interaction-design**        | Create micro-interactions, animations, and gesture-based interfaces |
| **visual-design-foundations** | Apply typography, color theory, spacing, and visual hierarchy       |

### 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      |

### Conductor - Project Management (3 skills)

| Skill                          | Description                                                                                             |
| ------------------------------ | ------------------------------------------------------------------------------------------------------- |
| **context-driven-development** | Apply Context-Driven Development methodology with product context, specifications, and phased planning  |
| **track-management**           | Manage development tracks for features, bugs, chores, and refactors with specs and implementation plans |
| **workflow-patterns**          | Implement TDD workflows, commit strategies, and verification checkpoints for systematic development     |

### Agent Teams (6 skills)

| Skill                              | Description                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **multi-reviewer-patterns**        | Coordinate parallel code reviews across quality dimensions with deduplication and severity calibration |
| **parallel-debugging**             | Debug complex issues using competing hypotheses, parallel investigation, and root-cause arbitration    |
| **parallel-feature-development**   | Coordinate parallel feature work with file ownership, conflict avoidance, and integration patterns    |
| **task-coordination-strategies**   | Decompose complex tasks, design dependency graphs, and balance workload across multi-agent teams      |
| **team-communication-protocols**   | Structured messaging for agent teams: message types, plan approval, and shutdown procedures           |
| **team-composition-patterns**      | Design optimal team compositions with sizing heuristics, presets, and agent type selection            |

### Reverse Engineering (4 skills)

| Skill                              | Description                                                                                          |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **anti-reversing-techniques**      | Understand anti-reversing, obfuscation, and protection techniques encountered during analysis        |
| **binary-analysis-patterns**       | Disassembly, decompilation, control flow analysis, and code pattern recognition                      |
| **memory-forensics**               | Memory acquisition, process analysis, and artifact extraction using Volatility and related tools     |
| **protocol-reverse-engineering**   | Network protocol reverse engineering including packet analysis and custom protocol documentation     |

### Startup Business Analyst (5 skills)

| Skill                              | Description                                                                                          |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **competitive-landscape**          | Competitive analysis, differentiation, and positioning using Porter's Five Forces and related models |
| **market-sizing-analysis**         | TAM/SAM/SOM calculations using top-down, bottom-up, and value-theory methodologies                   |
| **startup-financial-modeling**     | 3–5 year financial models with revenue, costs, cash flow, and scenario planning                      |
| **startup-metrics-framework**      | Track and optimize key SaaS, marketplace, consumer, and B2B startup metrics from seed to Series A    |
| **team-composition-analysis**      | Hiring plans, org structures, compensation, and equity allocation for early-stage startups           |

### Shell Scripting (3 skills)

| Skill                          | Description                                                                                  |
| ------------------------------ | -------------------------------------------------------------------------------------------- |
| **bash-defensive-patterns**    | Defensive Bash programming techniques for production-grade scripts                          |
| **bats-testing-patterns**      | Bash Automated Testing System (Bats) for comprehensive shell script testing                 |
| **shellcheck-configuration**   | ShellCheck static analysis configuration and usage for shell script quality                 |

### Database Design (1 skill)

| Skill                         | Description                                                       |
| ----------------------------- | ----------------------------------------------------------------- |
| **postgresql-table-design**   | Design and review PostgreSQL-specific schemas with proper modeling |

### Documentation Standards (1 skill)

| Skill    | Description                                                                                   |
| -------- | --------------------------------------------------------------------------------------------- |
| **hads** | HADS (Human-AI Document Standard) — semantic Markdown tagging for token-efficient AI reading |

### .NET Contribution (1 skill)

| Skill                          | Description                                                                       |
| ------------------------------ | --------------------------------------------------------------------------------- |
| **dotnet-backend-patterns**    | C#/.NET backend patterns for robust APIs, MCP servers, and enterprise applications |

### Plugin Eval (1 skill)

| Skill                       | Description                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| **evaluation-methodology**  | PluginEval quality methodology — dimensions, rubrics, statistical methods, scoring formulas |

### Block No-Verify (1 skill)

| Skill                      | Description                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| **block-no-verify-hook**   | PreToolUse hook preventing AI agents from skipping git pre-commit hooks via bypass flags         |

### Protect MCP (1 skill)

| Skill                  | Description                                                                                                                  |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **protect-mcp-setup**  | Configure Cedar policy enforcement and Ed25519 signed receipts for tool calls; example policies for research/dev/production  |

### Social Publishing (1 skill)

| Skill                  | Description                                                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **social-publishing**  | Schedule and publish social media posts across 13 platforms via the SocialClaw API                                       |

### LLM Fine-Tuning (10 skills)

| Skill                           | Description                                                                              |
| ------------------------------- | ---------------------------------------------------------------------------------------- |
| **eval-harness-first**          | Build the eval harness that gates every run: golden sets, graders, judge calibration     |
| **finetuning-method-selection** | Decide whether to fine-tune at all and route to the right method and base model          |
| **dataset-curation**            | Prepare, format, and validate datasets for SFT and preference training                   |
| **lora-qlora-recipes**          | Configure LoRA/QLoRA supervised fine-tuning with best-practice hyperparameters           |
| **preference-optimization**     | Align a fine-tuned model with preference data using DPO, ORPO, KTO, or SimPO             |
| **grpo-rlvr-training**          | Train reasoning and verifiable-task behavior with GRPO and RLVR reward functions         |
| **vision-sft**                  | Fine-tune vision-language models with supervised learning on image+text data             |
| **trace-to-training-data**      | Convert eval traces and production logs into SFT examples and preference pairs           |
| **checkpoint-promotion**        | Gate checkpoints with drift budgets, paired comparison, and forgetting checks            |
| **quantized-export**            | Export a promoted model as merged safetensors, LoRA-only, GGUF with imatrix, or FP8      |

### PPTX Deck Creation (5 skills)

| Skill                            | Description                                                                              |
| -------------------------------- | ---------------------------------------------------------------------------------------- |
| **pptx-deck-context**            | Prepare the narrative, sources, and design context for a new editable PPTX deck          |
| **pptx-slide-specification**     | Author or repair a coordinate-explicit JSON specification for an editable PPTX deck      |
| **pptx-visual-assets**           | Select and place approved icons, images, SVGs, diagrams, and infographics                |
| **pptx-reference-deck-analysis** | Analyze a reference PPTX read-only for structure, theme, typography, and layout rhythm   |
| **pptx-quality-gates**           | Validate or repair an editable PPTX deck for geometry, accessibility, and editability    |

### DGX Spark Ops (3 skills)

| Skill                        | Description                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------- |
| **spark-environment-setup**  | Set up ML training/inference environments on NVIDIA DGX Spark (GB10, aarch64, CUDA 13)  |
| **spark-training-gotchas**   | Preflight and diagnose the ten known failure modes for ML training on DGX Spark         |
| **spark-memory-thermal-ops** | Manage unified memory and thermals during long-running ML jobs on GB10                  |

## 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 181 skills follow the [Agent Skills Specification](https://agentskills.io/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
   ---
   ```

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)

---

## File: docs/agents.md

# Agent Reference

Complete reference for all **202 local specialized AI agents** organized by category with model assignments.

## Agent Categories

### Architecture & System Design

#### Core Architecture

| Agent                                                                                         | Model  | Description                                                            |
| --------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| [backend-architect](../plugins/backend-development/agents/backend-architect.md)               | opus   | RESTful API design, microservice boundaries, database schemas          |
| [frontend-developer](../plugins/multi-platform-apps/agents/frontend-developer.md)             | sonnet | React components, responsive layouts, client-side state management     |
| [graphql-architect](../plugins/backend-development/agents/graphql-architect.md)               | opus   | GraphQL schemas, resolvers, federation architecture                    |
| [architect-reviewer](../plugins/comprehensive-review/agents/architect-review.md)              | opus   | Architectural consistency analysis and pattern validation              |
| [cloud-architect](../plugins/cloud-infrastructure/agents/cloud-architect.md)                  | opus   | AWS/Azure/GCP infrastructure design and cost optimization              |
| [hybrid-cloud-architect](../plugins/cloud-infrastructure/agents/hybrid-cloud-architect.md)    | opus   | Multi-cloud strategies across cloud and on-premises environments       |
| [kubernetes-architect](../plugins/kubernetes-operations/agents/kubernetes-architect.md)       | opus   | Cloud-native infrastructure with Kubernetes and GitOps                 |
| [service-mesh-expert](../plugins/cloud-infrastructure/agents/service-mesh-expert.md)          | opus   | Istio/Linkerd service mesh architecture, mTLS, and traffic management  |
| [event-sourcing-architect](../plugins/backend-development/agents/event-sourcing-architect.md) | inherit| Event sourcing, CQRS patterns, event stores, and saga orchestration    |
| [monorepo-architect](../plugins/developer-essentials/agents/monorepo-architect.md)            | opus   | Monorepo tooling with Nx, Turborepo, Bazel, and workspace optimization |

#### UI/UX & Mobile

| Agent                                                                                    | Model  | Description                                             |
| ---------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------- |
| [ui-designer](../plugins/ui-design/agents/ui-designer.md)                                | opus   | UI/UX design for mobile and web with modern patterns    |
| [accessibility-expert](../plugins/ui-design/agents/accessibility-expert.md)              | opus   | WCAG compliance, accessibility audits, inclusive design |
| [design-system-architect](../plugins/ui-design/agents/design-system-architect.md)        | opus   | Design tokens, component libraries, theming systems     |
| [ui-ux-designer](../plugins/multi-platform-apps/agents/ui-ux-designer.md)                | sonnet | Interface design, wireframes, design systems            |
| [ui-visual-validator](../plugins/accessibility-compliance/agents/ui-visual-validator.md) | sonnet | Visual regression testing and UI verification           |
| [mobile-developer](../plugins/multi-platform-apps/agents/mobile-developer.md)            | sonnet | React Native and Flutter application development        |
| [ios-developer](../plugins/multi-platform-apps/agents/ios-developer.md)                  | sonnet | Native iOS development with Swift/SwiftUI               |
| [flutter-expert](../plugins/multi-platform-apps/agents/flutter-expert.md)                | sonnet | Advanced Flutter development with state management      |

### Programming Languages

#### Systems & Low-Level

| Agent                                                             | Model  | Description                                                 |
| ----------------------------------------------------------------- | ------ | ----------------------------------------------------------- |
| [c-pro](../plugins/systems-programming/agents/c-pro.md)           | sonnet | System programming with memory management and OS interfaces |
| [cpp-pro](../plugins/systems-programming/agents/cpp-pro.md)       | sonnet | Modern C++ with RAII, smart pointers, STL algorithms        |
| [rust-pro](../plugins/systems-programming/agents/rust-pro.md)     | sonnet | Memory-safe systems programming with ownership patterns     |
| [golang-pro](../plugins/systems-programming/agents/golang-pro.md) | opus   | Concurrent programming with goroutines and channels         |

#### Web & Application

| Agent                                                                               | Model  | Description                                                                       |
| ----------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------- |
| [javascript-pro](../plugins/javascript-typescript/agents/javascript-pro.md)         | sonnet | Modern JavaScript with ES6+, async patterns, Node.js                              |
| [typescript-pro](../plugins/javascript-typescript/agents/typescript-pro.md)         | sonnet | Advanced TypeScript with type systems and generics                                |
| [python-pro](../plugins/python-development/agents/python-pro.md)                    | sonnet | Python development with advanced features and optimization                        |
| [temporal-python-pro](../plugins/backend-development/agents/temporal-python-pro.md) | inherit| Temporal workflow orchestration with Python SDK, durable workflows, saga patterns |
| [ruby-pro](../plugins/web-scripting/agents/ruby-pro.md)                             | sonnet | Ruby with metaprogramming, Rails patterns, gem development                        |
| [php-pro](../plugins/web-scripting/agents/php-pro.md)                               | sonnet | Modern PHP with frameworks and performance optimization                           |

#### Enterprise & JVM

| Agent                                                       | Model  | Description                                                          |
| ----------------------------------------------------------- | ------ | -------------------------------------------------------------------- |
| [java-pro](../plugins/jvm-languages/agents/java-pro.md)     | sonnet | Modern Java with streams, concurrency, JVM optimization              |
| [scala-pro](../plugins/jvm-languages/agents/scala-pro.md)   | sonnet | Enterprise Scala with functional programming and distributed systems |
| [csharp-pro](../plugins/jvm-languages/agents/csharp-pro.md) | inherit| C# development with .NET frameworks and patterns                     |

#### Specialized Platforms

| Agent                                                                              | Model  | Description                                                                               |
| ---------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------- |
| [elixir-pro](../plugins/functional-programming/agents/elixir-pro.md)               | sonnet | Elixir with OTP patterns and Phoenix frameworks                                           |
| [django-pro](../plugins/api-scaffolding/agents/django-pro.md)                      | sonnet | Django development with ORM and async views                                               |
| [fastapi-pro](../plugins/api-scaffolding/agents/fastapi-pro.md)                    | sonnet | FastAPI with async patterns and Pydantic                                                  |
| [haskell-pro](../plugins/functional-programming/agents/haskell-pro.md)             | sonnet | Strongly typed functional programming with purity, advanced type systems, and concurrency |
| [unity-developer](../plugins/game-development/agents/unity-developer.md)           | sonnet | Unity game development and optimization                                                   |
| [minecraft-bukkit-pro](../plugins/game-development/agents/minecraft-bukkit-pro.md) | opus   | Minecraft server plugin development                                                       |
| [sql-pro](../plugins/database-design/agents/sql-pro.md)                            | sonnet | Complex SQL queries and database optimization                                             |

### Infrastructure & Operations

#### DevOps & Deployment

| Agent                                                                                  | Model  | Description                                                        |
| -------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------ |
| [devops-troubleshooter](../plugins/incident-response/agents/devops-troubleshooter.md)  | sonnet | Production debugging, log analysis, deployment troubleshooting     |
| [deployment-engineer](../plugins/cloud-infrastructure/agents/deployment-engineer.md)   | sonnet | CI/CD pipelines, containerization, cloud deployments               |
| [terraform-specialist](../plugins/cloud-infrastructure/agents/terraform-specialist.md) | opus   | Infrastructure as Code with Terraform modules and state management |
| [dx-optimizer](../plugins/team-collaboration/agents/dx-optimizer.md)                   | sonnet | Developer experience optimization and tooling improvements         |

#### Database Management

| Agent                                                                                  | Model  | Description                                                         |
| -------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------- |
| [database-optimizer](../plugins/observability-monitoring/agents/database-optimizer.md) | inherit| Query optimization, index design, migration strategies              |
| [database-admin](../plugins/database-migrations/agents/database-admin.md)              | sonnet | Database operations, backup, replication, monitoring                |
| [database-architect](../plugins/database-design/agents/database-architect.md)          | opus   | Database design from scratch, technology selection, schema modeling |

#### Incident Response & Network

| Agent                                                                              | Model  | Description                                         |
| ---------------------------------------------------------------------------------- | ------ | --------------------------------------------------- |
| [incident-responder](../plugins/incident-response/agents/incident-responder.md)    | opus   | Production incident management and resolution       |
| [network-engineer](../plugins/observability-monitoring/agents/network-engineer.md) | sonnet | Network debugging, load balancing, traffic analysis |

#### Project Management

| Agent                                                             | Model | Description                                                                          |
| ----------------------------------------------------------------- | ----- | ------------------------------------------------------------------------------------ |
| [conductor-validator](../plugins/conductor/agents/conductor-validator.md) | opus  | Validates Conductor project artifacts for completeness, consistency, and correctness |

### Quality Assurance & Security

#### Code Quality & Review

| Agent                                                                                            | Model | Description                                                     |
| ------------------------------------------------------------------------------------------------ | ----- | --------------------------------------------------------------- |
| [code-reviewer](../plugins/comprehensive-review/agents/code-reviewer.md)                         | opus  | Code review with security focus and production reliability      |
| [security-auditor](../plugins/comprehensive-review/agents/security-auditor.md)                   | opus  | Vulnerability assessment and OWASP compliance                   |
| [backend-security-coder](../plugins/data-validation-suite/agents/backend-security-coder.md)      | opus  | Secure backend coding practices, API security implementation    |
| [frontend-security-coder](../plugins/frontend-mobile-security/agents/frontend-security-coder.md) | sonnet| XSS prevention, CSP implementation, client-side security        |
| [mobile-security-coder](../plugins/frontend-mobile-security/agents/mobile-security-coder.md)     | opus  | Mobile security patterns, WebView security, biometric auth      |
| [threat-modeling-expert](../plugins/security-scanning/agents/threat-modeling-expert.md)          | opus  | STRIDE threat modeling, attack trees, and security requirements |

#### Testing & Debugging

| Agent                                                                         | Model  | Description                                                |
| ----------------------------------------------------------------------------- | ------ | ---------------------------------------------------------- |
| [test-automator](../plugins/codebase-cleanup/agents/test-automator.md)        | sonnet | Comprehensive test suite creation (unit, integration, e2e) |
| [tdd-orchestrator](../plugins/backend-development/agents/tdd-orchestrator.md) | opus   | Test-Driven Development methodology guidance               |
| [debugger](../plugins/error-debugging/agents/debugger.md)                     | sonnet | Error resolution and test failure analysis                 |
| [error-detective](../plugins/error-debugging/agents/error-detective.md)       | sonnet | Log analysis and error pattern recognition                 |

#### Performance & Observability

| Agent                                                                                          | Model | Description                                                    |
| ---------------------------------------------------------------------------------------------- | ----- | -------------------------------------------------------------- |
| [performance-engineer](../plugins/observability-monitoring/agents/performance-engineer.md)     | opus  | Application profiling and optimization                         |
| [observability-engineer](../plugins/observability-monitoring/agents/observability-engineer.md) | inherit| Production monitoring, distributed tracing, SLI/SLO management |
| [search-specialist](../plugins/content-marketing/agents/search-specialist.md)                  | haiku | Advanced web research and information synthesis                |

### Data & AI

#### Data Engineering & Analytics

| Agent                                                                      | Model  | Description                                             |
| -------------------------------------------------------------------------- | ------ | ------------------------------------------------------- |
| [data-scientist](../plugins/machine-learning-ops/agents/data-scientist.md) | inherit| Data analysis, SQL queries, BigQuery operations         |
| [data-engineer](../plugins/data-engineering/agents/data-engineer.md)       | sonnet | ETL pipelines, data warehouses, streaming architectures |

#### Machine Learning & AI

| Agent                                                                                         | Model | Description                                                           |
| --------------------------------------------------------------------------------------------- | ----- | --------------------------------------------------------------------- |
| [ai-engineer](../plugins/llm-application-dev/agents/ai-engineer.md)                           | opus  | LLM applications, RAG systems, prompt pipelines                       |
| [ml-engineer](../plugins/machine-learning-ops/agents/ml-engineer.md)                          | opus  | ML pipelines, model serving, feature engineering                      |
| [mlops-engineer](../plugins/machine-learning-ops/agents/mlops-engineer.md)                    | opus  | ML infrastructure, experiment tracking, model registries              |
| [prompt-engineer](../plugins/llm-application-dev/agents/prompt-engineer.md)                   | opus  | LLM prompt optimization and engineering                               |
| [vector-database-engineer](../plugins/llm-application-dev/agents/vector-database-engineer.md) | inherit| Vector databases, embeddings, similarity search, and hybrid retrieval |
| [llm-finetuning-architect](../plugins/llm-finetuning/agents/llm-finetuning-architect.md)      | opus  | Fine-tuning strategy, method/model selection, eval-gate ownership     |
| [llm-finetuning-training-engineer](../plugins/llm-finetuning/agents/llm-finetuning-training-engineer.md) | sonnet | Dataset prep, Unsloth training runs, artifact export         |
| [llm-finetuning-eval-engineer](../plugins/llm-finetuning/agents/llm-finetuning-eval-engineer.md) | sonnet | Golden sets, judge calibration, checkpoint promotion verdicts     |
| [dgx-spark-ops-engineer](../plugins/dgx-spark-ops/agents/dgx-spark-ops-engineer.md)           | sonnet | DGX Spark (GB10/aarch64/CUDA 13) environment setup and diagnostics   |

### Documentation & Technical Writing

| Agent                                                                                | Model  | Description                                                           |
| ------------------------------------------------------------------------------------ | ------ | --------------------------------------------------------------------- |
| [docs-architect](../plugins/code-documentation/agents/docs-architect.md)             | opus   | Comprehensive technical documentation generation                      |
| [api-documenter](../plugins/api-testing-observability/agents/api-documenter.md)      | sonnet | OpenAPI/Swagger specifications and developer docs                     |
| [reference-builder](../plugins/documentation-generation/agents/reference-builder.md) | haiku  | Technical references and API documentation                            |
| [tutorial-engineer](../plugins/code-documentation/agents/tutorial-engineer.md)       | sonnet | Step-by-step tutorials and educational content                        |
| [mermaid-expert](../plugins/documentation-generation/agents/mermaid-expert.md)       | sonnet | Diagram creation (flowcharts, sequences, ERDs)                        |
| [c4-code](../plugins/c4-architecture/agents/c4-code.md)                              | haiku  | C4 Code-level documentation with function signatures and dependencies |
| [c4-component](../plugins/c4-architecture/agents/c4-component.md)                    | sonnet | C4 Component-level architecture synthesis and documentation           |
| [c4-container](../plugins/c4-architecture/agents/c4-container.md)                    | sonnet | C4 Container-level architecture with API documentation                |
| [c4-context](../plugins/c4-architecture/agents/c4-context.md)                        | sonnet | C4 Context-level system documentation with personas and user journeys |

### Business & Operations

#### Business Analysis & Finance

| Agent                                                                        | Model  | Description                                             |
| ---------------------------------------------------------------------------- | ------ | ------------------------------------------------------- |
| [business-analyst](../plugins/business-analytics/agents/business-analyst.md) | sonnet | Metrics analysis, reporting, KPI tracking               |
| [quant-analyst](../plugins/quantitative-trading/agents/quant-analyst.md)     | opus   | Financial modeling, trading strategies, market analysis |
| [risk-manager](../plugins/quantitative-trading/agents/risk-manager.md)       | sonnet | Portfolio risk monitoring and management                |

#### Marketing & Sales

| Agent                                                                             | Model  | Description                                  |
| --------------------------------------------------------------------------------- | ------ | -------------------------------------------- |
| [content-marketer](../plugins/content-marketing/agents/content-marketer.md)       | sonnet | Blog posts, social media, email campaigns    |
| [social-publishing-publisher](../plugins/social-publishing/agents/social-publishing-publisher.md) | haiku | Multi-platform social media publishing via SocialClaw |
| [sales-automator](../plugins/customer-sales-automation/agents/sales-automator.md) | haiku  | Cold emails, follow-ups, proposal generation |

#### Support & Legal

| Agent                                                                               | Model  | Description                                             |
| ----------------------------------------------------------------------------------- | ------ | ------------------------------------------------------- |
| [customer-support](../plugins/customer-sales-automation/agents/customer-support.md) | haiku  | Support tickets, FAQ responses, customer communication  |
| [hr-pro](../plugins/hr-legal-compliance/agents/hr-pro.md)                           | opus   | HR operations, policies, employee relations             |
| [legal-advisor](../plugins/hr-legal-compliance/agents/legal-advisor.md)             | opus   | Privacy policies, terms of service, legal documentation |

### SEO & Content Optimization

| Agent                                                                                                     | Model  | Description                                          |
| --------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------- |
| [seo-content-auditor](../plugins/seo-content-creation/agents/seo-content-auditor.md)                      | sonnet | Content quality analysis, E-E-A-T signals assessment |
| [seo-meta-optimizer](../plugins/seo-technical-optimization/agents/seo-meta-optimizer.md)                  | haiku  | Meta title and description optimization              |
| [seo-keyword-strategist](../plugins/seo-technical-optimization/agents/seo-keyword-strategist.md)          | haiku  | Keyword analysis and semantic variations             |
| [seo-structure-architect](../plugins/seo-technical-optimization/agents/seo-structure-architect.md)        | haiku  | Content structure and schema markup                  |
| [seo-snippet-hunter](../plugins/seo-technical-optimization/agents/seo-snippet-hunter.md)                  | haiku  | Featured snippet formatting                          |
| [seo-content-refresher](../plugins/seo-analysis-monitoring/agents/seo-content-refresher.md)               | haiku  | Content freshness analysis                           |
| [seo-cannibalization-detector](../plugins/seo-analysis-monitoring/agents/seo-cannibalization-detector.md) | haiku  | Keyword overlap detection                            |
| [seo-authority-builder](../plugins/seo-analysis-monitoring/agents/seo-authority-builder.md)               | sonnet | E-E-A-T signal analysis                              |
| [seo-content-writer](../plugins/seo-content-creation/agents/seo-content-writer.md)                        | sonnet | SEO-optimized content creation                       |
| [seo-content-planner](../plugins/seo-content-creation/agents/seo-content-planner.md)                      | haiku  | Content planning and topic clusters                  |

### Specialized Domains

| Agent                                                                                   | Model  | Description                                             |
| --------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------- |
| [arm-cortex-expert](../plugins/arm-cortex-microcontrollers/agents/arm-cortex-expert.md) | inherit| ARM Cortex-M firmware and peripheral driver development |
| [blockchain-developer](../plugins/blockchain-web3/agents/blockchain-developer.md)       | sonnet | Web3 apps, smart contracts, DeFi protocols              |
| [payment-integration](../plugins/payment-processing/agents/payment-integration.md)      | sonnet | Payment processor integration (Stripe, PayPal)          |
| [legacy-modernizer](../plugins/framework-migration/agents/legacy-modernizer.md)         | fable  | Legacy code refactoring and modernization               |
| [context-manager](../plugins/agent-orchestration/agents/context-manager.md)             | haiku  | Multi-agent context management                          |
| [pptx-deck-creation-builder](../plugins/pptx-deck-creation/agents/pptx-deck-creation-builder.md) | inherit | Production-ready editable PPTX decks from briefs or reference decks |

## Model Configuration

Agents are assigned to specific Claude models based on task complexity and computational requirements.

### Model Distribution Summary

| Model   | Agent Count | Use Case                                                        |
| ------- | ----------- | --------------------------------------------------------------- |
| Fable   | 2           | Longest-horizon autonomous work (tier above Opus; see criteria) |
| Opus    | 54          | Critical architecture, security, code review, production coding |
| Sonnet  | 70          | Complex tasks, support with intelligence                        |
| Haiku   | 24          | Fast operational tasks                                          |
| Inherit | 52          | Complex tasks where the user chooses the model at runtime       |

### Model Selection Criteria

#### Haiku - Fast Execution & Deterministic Tasks

**Use when:**

- Generating code from well-defined specifications
- Creating tests following established patterns
- Writing documentation with clear templates
- Executing infrastructure operations
- Performing database query optimization
- Handling customer support responses
- Processing SEO optimization tasks
- Managing deployment pipelines

#### Sonnet - Complex Reasoning & Architecture

**Use when:**

- Designing system architecture
- Making technology selection decisions
- Performing security audits
- Reviewing code for architectural patterns
- Creating complex AI/ML pipelines
- Providing language-specific expertise
- Orchestrating multi-agent workflows
- Handling business-critical legal/HR matters

#### Fable - Longest-Horizon Autonomous Work

Claude Fable 5 (`model: fable`) is the tier above Opus. It is opt-in in Claude Code
(v2.1.170+, never the default) and carries roughly 2.6× the effective cost of Opus
($10/$50 per MTok plus a ~30% heavier tokenizer), so reserve it for agents where Opus
demonstrably needs multiple attempts.

**Use when:**

- Running multi-hour autonomous sessions (large codebase migrations, overnight refactors)
- Executing end-to-end work from a single well-specified goal
- Coordinating long-lived parallel sub-agent workstreams

**Avoid for:**

- Security-analysis agents — Fable 5's cyber/bio safety classifiers fall back to
  Opus 4.8 on that content anyway
- Anything Sonnet or Opus already completes in one pass

Other harnesses map `fable` to their top available model (see
[authoring.md](authoring.md#model-aliases)). Fable-tier agent bodies should state goals
and constraints rather than step-by-step scaffolding, and must not ask the model to echo
its internal reasoning.

### Hybrid Orchestration Patterns

The plugin ecosystem leverages Sonnet + Haiku orchestration for optimal performance and cost efficiency:

#### Pattern 1: Planning → Execution

```
Sonnet: backend-architect (design API architecture)
  ↓
Haiku: Generate API endpoints following spec
  ↓
Haiku: test-automator (generate comprehensive tests)
  ↓
Sonnet: code-reviewer (architectural review)
```

#### Pattern 2: Reasoning → Action (Incident Response)

```
Sonnet: incident-responder (diagnose issue, create strategy)
  ↓
Haiku: devops-troubleshooter (execute fixes)
  ↓
Haiku: deployment-engineer (deploy hotfix)
  ↓
Haiku: Implement monitoring alerts
```

#### Pattern 3: Complex → Simple (Database Design)

```
Sonnet: database-architect (schema design, technology selection)
  ↓
Haiku: sql-pro (generate migration scripts)
  ↓
Haiku: database-admin (execute migrations)
  ↓
Haiku: database-optimizer (tune query performance)
```

#### Pattern 4: Multi-Agent Workflows

```
Full-Stack Feature Development:
Sonnet: backend-architect + frontend-developer (design components)
  ↓
Haiku: Generate code following designs
  ↓
Haiku: test-automator (unit + integration tests)
  ↓
Sonnet: security-auditor (security review)
  ↓
Haiku: deployment-engineer (CI/CD setup)
  ↓
Haiku: Setup observability stack
```

## Agent Invocation

### Natural Language

Agents can be invoked through natural language when you need Claude to reason about which specialist to use:

```
"Use backend-architect to design the authentication API"
"Have security-auditor scan for OWASP vulnerabilities"
"Get performance-engineer to optimize this database query"
```

### Slash Commands

Many agents are accessible through plugin slash commands for direct invocation:

```bash
/backend-development:feature-development user authentication
/security-scanning:security-sast
/incident-response:smart-fix "memory leak in payment service"
```

## Contributing

To add a new agent:

1. Create `plugins/{plugin-name}/agents/{agent-name}.md`
2. Add frontmatter with name, description, and model assignment
3. Write comprehensive system prompt
4. Update plugin definition in `.claude-plugin/marketplace.json`

See [Contributing Guide](../CONTRIBUTING.md) for details.

---

## File: docs/architecture.md

# Architecture & Design Principles

This marketplace follows industry best practices with a focus on granularity, composability, and minimal token usage.

## Core Philosophy

### Single Responsibility Principle

- Each plugin does **one thing well** (Unix philosophy)
- Clear, focused purposes (describable in 5-10 words)
- Average plugin size: **5.5 components** (follows Anthropic's 2-8 pattern)
- **Zero bloated plugins** - all plugins focused and purposeful

### Composability Over Bundling

- Mix and match plugins based on needs
- Workflow orchestrators compose focused plugins
- No forced feature bundling
- Clear boundaries between plugins

### Context Efficiency

- Smaller tools = faster processing
- Better fit in LLM context windows
- More accurate, focused responses
- Install only what you need

### Maintainability

- Single-purpose = easier updates
- Clear boundaries = isolated changes
- Less duplication = simpler maintenance
- Isolated dependencies

## Granular Plugin Architecture

### Plugin Distribution

- **92 marketplace plugins** (91 local + 1 external via git-subdir) optimized for specific use cases
- **26 clear categories** with 1-10 plugins each for easy discovery
- Organized by domain:
  - **Development**: 6 plugins (debugging, backend, frontend, UI, multi-platform, essentials)
  - **Security**: 6 plugins (scanning, compliance, API, frontend/mobile, reverse engineering, hook policy)
  - **Operations**: 4 plugins (incident, diagnostics, distributed, observability)
  - **Languages**: 10 plugins (Python, JS/TS, systems, JVM, scripting, functional, embedded, and more)
  - **Infrastructure**: 5 plugins (deployment, validation, K8s, cloud, CI/CD)
  - And 21 more specialized categories

### Component Breakdown

**202 Local Specialized Agents**

- Domain experts with deep knowledge
- Organized across architecture, languages, infrastructure, quality, data/AI, documentation, business, and SEO
- Model-optimized with a five-tier strategy (Fable, Opus, Sonnet, Haiku, Inherit) for performance and cost

**16 Workflow Orchestrators**

- Multi-agent coordination systems
- Complex operations like full-stack development, security hardening, ML pipelines, incident response
- Pre-configured agent workflows

**105 Local Commands**

- Optimized utilities including:
  - Project scaffolding (Python, TypeScript, Rust)
  - Security scanning (SAST, dependency audit, XSS)
  - Test generation (pytest, Jest)
  - Component scaffolding (React, React Native)
  - Infrastructure setup (Terraform, Kubernetes)

**181 Local Agent Skills**

- Modular knowledge packages
- Progressive disclosure architecture
- Domain-specific expertise across 49 plugins
- Spec-compliant (Anthropic Agent Skills Specification)

## Repository Structure

```
/* Detailed source-code truncated for AI context efficiency. */
```

## Plugin Structure

Each plugin contains:

- **agents/** - Specialized agents for that domain (optional)
- **commands/** - Tools and workflows specific to that plugin (optional)
- **skills/** - Modular knowledge packages with progressive disclosure (optional)

### Minimum Requirements

- At least one agent, command, OR skill
- Clear, focused purpose
- Proper frontmatter in all files
- Entry in marketplace.json

### Example Plugin

```
plugins/kubernetes-operations/
├── agents/
│   └── kubernetes-architect.md   # K8s architecture and design
├── commands/
│   └── k8s-deploy.md            # Deployment automation
└── skills/
    ├── k8s-manifest-generator/   # Manifest creation skill
    ├── helm-chart-scaffolding/   # Helm chart skill
    ├── gitops-workflow/          # GitOps automation skill
    └── k8s-security-policies/    # Security policy skill
```

## Agent Skills Architecture

### 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)

### Specification Compliance

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

```yaml
---
name: skill-name # Required: hyphen-case
---
# Skill content with progressive disclosure
```

### 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

See [Agent Skills](./agent-skills.md) for complete details on the 181 skills.

## Model Configuration Strategy

### Five-Tier Architecture

The system uses Claude Fable, Opus, Sonnet, Haiku, and Inherit assignments strategically:

| Model   | Count     | Use Case                                        |
| ------- | --------- | ----------------------------------------------- |
| Fable   | 2 agents  | Longest-horizon autonomous work (opt-in tier)   |
| Opus    | 54 agents | Critical architecture, security, code review    |
| Sonnet  | 70 agents | Complex tasks, support with intelligence        |
| Haiku   | 24 agents | Fast operational tasks                          |
| Inherit | 52 agents | Defers model choice to the user at runtime      |

### Selection Criteria

**Haiku - Fast Execution & Deterministic Tasks**

- Generating code from well-defined specifications
- Creating tests following established patterns
- Writing documentation with clear templates
- Executing infrastructure operations
- Performing database query optimization
- Handling customer support responses
- Processing SEO optimization tasks
- Managing deployment pipelines

**Sonnet - Complex Reasoning & Architecture**

- Designing system architecture
- Making technology selection decisions
- Performing security audits
- Reviewing code for architectural patterns
- Creating complex AI/ML pipelines
- Providing language-specific expertise
- Orchestrating multi-agent workflows
- Handling business-critical legal/HR matters

### Hybrid Orchestration

Combine models for optimal performance and cost:

```
Planning Phase (Sonnet) → Execution Phase (Haiku) → Review Phase (Sonnet)

Example:
backend-architect (Sonnet) designs API
  ↓
Generate endpoints (Haiku) implements spec
  ↓
test-automator (Haiku) creates tests
  ↓
code-reviewer (Sonnet) validates architecture
```

## Performance & Quality

### Optimized Token Usage

- **Isolated plugins** load only what you need
- **Granular architecture** reduces unnecessary context
- **Progressive disclosure** (skills) loads knowledge on demand
- **Clear boundaries** prevent context pollution

### Component Coverage

- **Full component coverage** - every plugin includes at least one agent, command, or skill
- **100% component availability** - all 202 local agents accessible across plugins
- **Efficient distribution** - 5.5 components per plugin average

### Discoverability

- **Clear plugin names** convey purpose immediately
- **Logical categorization** with 26 well-defined categories
- **Searchable documentation** with cross-references
- **Easy to find** the right tool for the job

## Design Patterns

### Pattern 1: Single-Purpose Plugin

Each plugin focuses on one domain:

```
python-development/
├── agents/           # Python language experts
├── commands/         # Python project scaffolding
└── skills/           # Python-specific knowledge
```

**Benefits:**

- Clear responsibility
- Easy to maintain
- Minimal token usage
- Composable with other plugins

### Pattern 2: Workflow Orchestration

Orchestrator plugins coordinate multiple agents:

```
full-stack-orchestration/
└── commands/
    └── full-stack-feature.md    # Coordinates 7+ agents
```

**Orchestration:**

1. backend-architect (design API)
2. database-architect (design schema)
3. frontend-developer (build UI)
4. test-automator (create tests)
5. security-auditor (security review)
6. deployment-engineer (CI/CD)
7. observability-engineer (monitoring)

### Pattern 3: Agent + Skill Integration

Agents provide reasoning, skills provide knowledge:

```
User: "Build FastAPI project with async patterns"
  ↓
fastapi-pro agent (orchestrates)
  ↓
fastapi-templates skill (provides patterns)
  ↓
python-scaffold command (generates project)
```

### Pattern 4: Multi-Plugin Composition

Complex workflows use multiple plugins:

```
Feature Development Workflow:
1. backend-development:feature-development
2. security-scanning:security-hardening
3. unit-testing:test-generate
4. comprehensive-review:full-review
5. cicd-automation:workflow-automate
6. observability-monitoring:monitor-setup
```

## Versioning & Updates

### Marketplace Updates

- Marketplace catalog in `.claude-plugin/marketplace.json`
- Semantic versioning for plugins
- Backward compatibility maintained
- Clear migration guides for breaking changes

### Plugin Updates

- Individual plugin updates don't affect others
- Skills can be updated independently
- Agents can be added/removed without breaking workflows
- Commands maintain stable interfaces

## Contributing Guidelines

### Adding a Plugin

1. Create plugin directory: `plugins/{plugin-name}/`
2. Add agents and/or commands
3. Optionally add skills
4. Update marketplace.json
5. Document in appropriate category

### Adding an Agent

1. Create `plugins/{plugin-name}/agents/{agent-name}.md`
2. Add frontmatter (name, description, model)
3. Write comprehensive system prompt
4. Update plugin definition

### Adding a Skill

1. Create `plugins/{plugin-name}/skills/{skill-name}/SKILL.md`
2. Add YAML frontmatter (name, description with "Use when")
3. Write skill content with progressive disclosure
4. Add to plugin's skills array in marketplace.json

### Quality Standards

- **Clear naming** - Hyphen-case, descriptive
- **Focused scope** - Single responsibility
- **Complete documentation** - What, when, how
- **Tested functionality** - Verify before committing
- **Spec compliance** - Follow Anthropic guidelines

## See Also

- [Agent Skills](./agent-skills.md) - Modular knowledge packages
- [Agent Reference](./agents.md) - Complete agent catalog
- [Plugin Reference](./plugins.md) - All 92 marketplace plugins
- [Usage Guide](./usage.md) - Commands and workflows

---

## File: docs/plugins.md

# Complete Plugin Reference

Browse all **92 marketplace plugins** organized by category: 91 local plugins plus 1 externally hosted `git-subdir` entry (`pensyve`).

## Quick Start - Essential Plugins

> 💡 **Getting Started?** Install these popular plugins for immediate productivity gains.

### Development Essentials

**code-documentation** - Documentation and technical writing

```bash
/plugin install code-documentation
```

Automated doc generation, code explanation, and tutorial creation for comprehensive technical documentation.

**debugging-toolkit** - Smart debugging and developer experience

```bash
/plugin install debugging-toolkit
```

Interactive debugging, error analysis, and DX optimization for faster problem resolution.

**git-pr-workflows** - Git automation and PR enhancement

```bash
/plugin install git-pr-workflows
```

Git workflow automation, pull request enhancement, and team onboarding processes.

### Full-Stack Development

**backend-development** - Backend API design and architecture

```bash
/plugin install backend-development
```

RESTful and GraphQL API design with test-driven development and modern backend architecture patterns.

**frontend-mobile-development** - UI and mobile development

```bash
/plugin install frontend-mobile-development
```

React/React Native component development with automated scaffolding and cross-platform implementation.

**full-stack-orchestration** - End-to-end feature development

```bash
/plugin install full-stack-orchestration
```

Multi-agent coordination from backend → frontend → testing → security → deployment.

### Testing & Quality

**unit-testing** - Automated test generation

```bash
/plugin install unit-testing
```

Generate pytest (Python) and Jest (JavaScript) unit tests automatically with comprehensive edge case coverage.

### Infrastructure & Operations

**cloud-infrastructure** - Cloud architecture design

```bash
/plugin install cloud-infrastructure
```

AWS/Azure/GCP architecture, Kubernetes setup, Terraform IaC, and multi-cloud cost optimization.

**incident-response** - Production incident management

```bash
/plugin install incident-response
```

Rapid incident triage, root cause analysis, and automated resolution workflows for production systems.

### Language Support

**python-development** - Python project scaffolding

```bash
/plugin install python-development
```

FastAPI/Django project initialization with modern tooling (uv, ruff) and production-ready architecture.

**javascript-typescript** - JavaScript/TypeScript scaffolding

```bash
/plugin install javascript-typescript
```

Next.js, React + Vite, and Node.js project setup with pnpm and TypeScript best practices.

---

## Complete Plugin Catalog

### 🎨 Development (6 plugins)

| Plugin                          | Description                                                  | Install                                       |
| ------------------------------- | ------------------------------------------------------------ | --------------------------------------------- |
| **debugging-toolkit**           | Interactive debugging and DX optimization                    | `/plugin install debugging-toolkit`           |
| **backend-development**         | Backend API design with GraphQL and TDD                      | `/plugin install backend-development`         |
| **frontend-mobile-development** | Frontend UI and mobile development                           | `/plugin install frontend-mobile-development` |
| **ui-design**                   | UI/UX design for mobile (iOS, Android, React Native) and web | `/plugin install ui-design`                   |
| **multi-platform-apps**         | Cross-platform app coordination (web/iOS/Android)            | `/plugin install multi-platform-apps`         |
| **developer-essentials**        | Essential Git, SQL, code review, auth, debugging, and monorepo skills | `/plugin install developer-essentials`        |

### 📚 Documentation (5 plugins)

| Plugin                       | Description                                                                                                                                     | Install                                    |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **documentation-standards**  | HADS semantic tagging conventions for human- and AI-friendly documentation                                                                       | `/plugin install documentation-standards`  |
| **code-documentation**       | Documentation generation and code explanation                                                                                                   | `/plugin install code-documentation`       |
| **documentation-generation** | OpenAPI specs, Mermaid diagrams, tutorials                                                                                                      | `/plugin install documentation-generation` |
| **c4-architecture**          | Comprehensive C4 architecture documentation workflow with bottom-up code analysis, component synthesis, container mapping, and context diagrams | `/plugin install c4-architecture`          |
| **avoid-ai-writing**         | Audit and rewrite prose that reads as machine-generated across READMEs, changelogs, PR descriptions, and docs                                    | `/plugin install avoid-ai-writing`         |

### 🔄 Workflows (7 plugins)

| Plugin                       | Description                                                                    | Install                                    |
| ---------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------ |
| **conductor**                | Context-Driven Development with tracks, specs, and phased implementation plans | `/plugin install conductor`                |
| **git-pr-workflows**         | Git automation and PR enhancement                                              | `/plugin install git-pr-workflows`         |
| **full-stack-orchestration** | End-to-end feature orchestration                                               | `/plugin install full-stack-orchestration` |
| **operating-kit**            | Session lifecycle, pre-ship review, deploy with live verification + state doc update, prod log health check | `/plugin install operating-kit`            |
| **tdd-workflows**            | Test-driven development methodology                                            | `/plugin install tdd-workflows`            |
| **agent-teams**              | Parallel code review, debugging, feature, and research teams                   | `/plugin install agent-teams`              |
| **ship-mate**                | Story-file to reviewed, tested PR workflow orchestration                       | `/plugin install ship-mate`                |

### ✅ Testing (1 plugin)

| Plugin             | Description                                                                          | Install                          |
| ------------------ | ------------------------------------------------------------------------------------ | -------------------------------- |
| **unit-testing**   | Automated unit test generation (Python/JavaScript)                                   | `/plugin install unit-testing`   |

### 🔍 Quality (4 plugins)

| Plugin                         | Description                                   | Install                                      |
| ------------------------------ | --------------------------------------------- | -------------------------------------------- |
| **comprehensive-review**       | Multi-perspective code analysis               | `/plugin install comprehensive-review`       |
| **performance-testing-review** | Performance analysis and test coverage review | `/plugin install performance-testing-review` |
| **plugin-eval**                | Three-layer quality evaluation framework for Claude Code plugins | `/plugin install plugin-eval`                |
| **skill-forge-essentials**    | Behavioral skills for AI code debt detection and session compaction survival | `/plugin install skill-forge-essentials`    |

### 🛠️ Utilities (5 plugins)

| Plugin                    | Description                                | Install                                 |
| ------------------------- | ------------------------------------------ | --------------------------------------- |
| **code-refactoring**      | Code cleanup and technical debt management | `/plugin install code-refactoring`      |
| **dependency-management** | Dependency auditing and version management | `/plugin install dependency-management` |
| **error-debugging**       | Error analysis and trace debugging         | `/plugin install error-debugging`       |
| **file-conversion**       | Convert files across 1,000+ format pairs   | `/plugin install file-conversion`       |
| **team-collaboration**    | Team workflows and standup automation      | `/plugin install team-collaboration`    |

### 🤖 AI & ML (6 plugins)

| Plugin                   | Description                         | Install                                |
| ------------------------ | ----------------------------------- | -------------------------------------- |
| **llm-application-dev**  | LLM apps and prompt engineering     | `/plugin install llm-application-dev`  |
| **agent-orchestration**  | Multi-agent system optimization     | `/plugin install agent-orchestration`  |
| **context-management**   | Context persistence and restoration | `/plugin install context-management`   |
| **machine-learning-ops** | ML training pipelines and MLOps     | `/plugin install machine-learning-ops` |
| **llm-finetuning**       | Eval-gated LLM fine-tuning lifecycle: dataset prep, LoRA/QLoRA training, and promotion gating | `/plugin install llm-finetuning`       |
| **dgx-spark-ops**        | NVIDIA DGX Spark (GB10) environment ops: aarch64/CUDA-13 stack setup, training preflights, unified-memory/thermal management | `/plugin install dgx-spark-ops`        |

### 🧠 Memory (1 external plugin)

| Plugin      | Description                                                                                  | Install                   |
| ----------- | -------------------------------------------------------------------------------------------- | ------------------------- |
| **pensyve** | Cross-session memory runtime with MCP-backed recall, skills, commands, agents, and hooks     | `/plugin install pensyve` |

### 📊 Data (2 plugins)

| Plugin                    | Description                        | Install                                 |
| ------------------------- | ---------------------------------- | --------------------------------------- |
| **data-engineering**      | ETL pipelines and data warehouses  | `/plugin install data-engineering`      |
| **data-validation-suite** | Schema validation and data quality | `/plugin install data-validation-suite` |

### 🗄️ Database (2 plugins)

| Plugin                  | Description                             | Install                               |
| ----------------------- | --------------------------------------- | ------------------------------------- |
| **database-design**     | Database architecture and schema design | `/plugin install database-design`     |
| **database-migrations** | Database migration automation           | `/plugin install database-migrations` |

### 🚨 Operations (4 plugins)

| Plugin                       | Description                           | Install                                    |
| ---------------------------- | ------------------------------------- | ------------------------------------------ |
| **incident-response**        | Production incident management        | `/plugin install incident-response`        |
| **error-diagnostics**        | Error tracing and root cause analysis | `/plugin install error-diagnostics`        |
| **distributed-debugging**    | Distributed system tracing            | `/plugin install distributed-debugging`    |
| **observability-monitoring** | Metrics, logging, tracing, and SLO    | `/plugin install observability-monitoring` |

### ⚡ Performance (2 plugins)

| Plugin                          | Description                                | Install                                       |
| ------------------------------- | ------------------------------------------ | --------------------------------------------- |
| **application-performance**     | Application profiling and optimization     | `/plugin install application-performance`     |
| **database-cloud-optimization** | Database query and cloud cost optimization | `/plugin install database-cloud-optimization` |

### ☁️ Infrastructure (5 plugins)

| Plugin                    | Description                                 | Install                                 |
| ------------------------- | ------------------------------------------- | --------------------------------------- |
| **deployment-strategies** | Deployment patterns and rollback automation | `/plugin install deployment-strategies` |
| **deployment-validation** | Pre-deployment checks and validation        | `/plugin install deployment-validation` |
| **kubernetes-operations** | K8s manifests and GitOps workflows          | `/plugin install kubernetes-operations` |
| **cloud-infrastructure**  | AWS/Azure/GCP cloud architecture            | `/plugin install cloud-infrastructure`  |
| **cicd-automation**       | CI/CD pipeline configuration                | `/plugin install cicd-automation`       |

### 🔒 Security (6 plugins)

| Plugin                       | Description                                                     | Install                                    |
| ---------------------------- | --------------------------------------------------------------- | ------------------------------------------ |
| **security-scanning**        | SAST analysis and vulnerability scanning                        | `/plugin install security-scanning`        |
| **security-compliance**      | SOC2/HIPAA/GDPR compliance                                      | `/plugin install security-compliance`      |
| **backend-api-security**     | API security and authentication                                 | `/plugin install backend-api-security`     |
| **frontend-mobile-security** | XSS/CSRF prevention and mobile security                         | `/plugin install frontend-mobile-security` |
| **reverse-engineering**      | Binary analysis, malware triage, firmware security (authorized) | `/plugin install reverse-engineering`      |
| **block-no-verify**          | PreToolUse hook blocking `--no-verify` and hook-bypass flags    | `/plugin install block-no-verify`          |

### 🛡️ Governance (3 plugins)

| Plugin                      | Description                                                                                                             | Install                                   |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| **protect-mcp**             | Cedar policy enforcement + Ed25519 signed receipts for every tool call; offline-verifiable audit trail via hash chaining | `/plugin install protect-mcp`             |
| **signed-audit-trails**     | Cookbook-style signed audit trail patterns for Claude Code tool calls                                                   | `/plugin install signed-audit-trails`     |
| **review-agent-governance** | Human approval governance before AI agents post reviews, comments, merges, or CI writes                                 | `/plugin install review-agent-governance` |

### 🔄 Modernization (2 plugins)

| Plugin                  | Description                               | Install                               |
| ----------------------- | ----------------------------------------- | ------------------------------------- |
| **framework-migration** | Framework upgrades and migration planning | `/plugin install framework-migration` |
| **codebase-cleanup**    | Technical debt reduction and cleanup      | `/plugin install codebase-cleanup`    |

### 🌐 API (2 plugins)

| Plugin                        | Description                 | Install                                     |
| ----------------------------- | --------------------------- | ------------------------------------------- |
| **api-scaffolding**           | REST/GraphQL API generation | `/plugin install api-scaffolding`           |
| **api-testing-observability** | API testing and monitoring  | `/plugin install api-testing-observability` |

### 📢 Marketing (5 plugins)

| Plugin                         | Description                             | Install                                      |
| ------------------------------ | --------------------------------------- | -------------------------------------------- |
| **seo-content-creation**       | SEO content writing and planning        | `/plugin install seo-content-creation`       |
| **seo-technical-optimization** | Meta tags, keywords, and schema markup  | `/plugin install seo-technical-optimization` |
| **seo-analysis-monitoring**    | Content analysis and authority building | `/plugin install seo-analysis-monitoring`    |
| **content-marketing**          | Content strategy and web research       | `/plugin install content-marketing`          |
| **social-publishing**          | Multi-platform social media publishing  | `/plugin install social-publishing`          |

### 💼 Business (5 plugins)

| Plugin                        | Description                          | Install                                     |
| ----------------------------- | ------------------------------------ | ------------------------------------------- |
| **business-analytics**        | KPI tracking and financial reporting | `/plugin install business-analytics`        |
| **startup-business-analyst**  | Market sizing, financial modeling, team planning, and strategic research for startups | `/plugin install startup-business-analyst`  |
| **before-you-build**          | Pre-build product risk review for founders, product teams, and AI-assisted builders | `/plugin install before-you-build`          |
| **hr-legal-compliance**       | HR policies and legal templates      | `/plugin install hr-legal-compliance`       |
| **customer-sales-automation** | Support and sales automation         | `/plugin install customer-sales-automation` |

### 💻 Languages (10 plugins)

| Plugin                          | Description                              | Install                                       |
| ------------------------------- | ---------------------------------------- | --------------------------------------------- |
| **python-development**          | Python 3.12+ with Django/FastAPI         | `/plugin install python-development`          |
| **javascript-typescript**       | JavaScript/TypeScript with Node.js       | `/plugin install javascript-typescript`       |
| **systems-programming**         | Rust, Go, C, C++ for systems development | `/plugin install systems-programming`         |
| **jvm-languages**               | Java, Scala, C# with enterprise patterns | `/plugin install jvm-languages`               |
| **web-scripting**               | PHP and Ruby for web applications        | `/plugin install web-scripting`               |
| **functional-programming**      | Elixir with OTP and Phoenix              | `/plugin install functional-programming`      |
| **julia-development**           | Julia scientific computing and high-performance numerical code | `/plugin install julia-development`           |
| **arm-cortex-microcontrollers** | ARM Cortex-M firmware and drivers        | `/plugin install arm-cortex-microcontrollers` |
| **shell-scripting**             | Production-grade Bash and POSIX shell scripting | `/plugin install shell-scripting`             |
| **dotnet-contribution**         | C#/.NET backend development with ASP.NET Core, EF Core, and Dapper | `/plugin install dotnet-contribution`         |

### 🔗 Blockchain (1 plugin)

| Plugin              | Description                        | Install                           |
| ------------------- | ---------------------------------- | --------------------------------- |
| **blockchain-web3** | Smart contracts and DeFi protocols | `/plugin install blockchain-web3` |

### 💰 Finance (1 plugin)

| Plugin                   | Description                             | Install                                |
| ------------------------ | --------------------------------------- | -------------------------------------- |
| **quantitative-trading** | Algorithmic trading and risk management | `/plugin install quantitative-trading` |

### 💳 Payments (1 plugin)

| Plugin                 | Description                           | Install                              |
| ---------------------- | ------------------------------------- | ------------------------------------ |
| **payment-processing** | Stripe/PayPal integration and billing | `/plugin install payment-processing` |

### 🎮 Gaming (1 plugin)

| Plugin               | Description                            | Install                            |
| -------------------- | -------------------------------------- | ---------------------------------- |
| **game-development** | Unity and Minecraft plugin development | `/plugin install game-development` |

### ♿ Accessibility (1 plugin)

| Plugin                       | Description                        | Install                                    |
| ---------------------------- | ---------------------------------- | ------------------------------------------ |
| **accessibility-compliance** | WCAG auditing and inclusive design | `/plugin install accessibility-compliance` |

### 🎨 Creative (3 plugins)

| Plugin               | Description                                                              | Install                            |
| -------------------- | ------------------------------------------------------------------------ | ---------------------------------- |
| **meigen-ai-design** | AI image generation with creative workflow orchestration and prompt MCPs | `/plugin install meigen-ai-design` |
| **brand-landingpage** | Brand discovery through deployment-ready landing page HTML              | `/plugin install brand-landingpage` |
| **pptx-deck-creation** | Production-ready editable PowerPoint decks via spec-first, coordinate-explicit workflow | `/plugin install pptx-deck-creation` |

## Plugin Structure

Each plugin contains:

- **agents/** - Specialized agents for that domain
- **commands/** - Tools and workflows specific to that plugin
- **skills/** - Optional modular knowledge packages (progressive disclosure)

Example:

```
plugins/python-development/
├── agents/
│   ├── python-pro.md
│   ├── django-pro.md
│   └── fastapi-pro.md
├── commands/
│   └── python-scaffold.md
└── skills/
    ├── async-python-patterns/
    ├── python-testing-patterns/
    ├── python-packaging/
    ├── python-performance-optimization/
    └── uv-package-manager/
```

## Installation

### Step 1: Add the Marketplace

```bash
/plugin marketplace add wshobson/agents
```

This makes all 92 marketplace plugins available for installation, but **does not load any agents or tools** into your context.

### Step 2: Install Specific Plugins

Browse available plugins:

```bash
/plugin
```

Install only the plugins you need:

```bash
/plugin install python-development
/plugin install backend-development
```

Each installed plugin loads **only its specific agents, commands, and skills** into Claude's context.

## Plugin Design Principles

### Single Responsibility

- Each plugin does **one thing well** (Unix philosophy)
- Clear, focused purposes (describable in 5-10 words)
- Average plugin size: **3.6 components** (follows Anthropic's 2-8 pattern)

### Minimal Token Usage

- Install only what you need
- Each plugin loads only its specific agents and tools
- No unnecessary resources loaded into context
- Better context efficiency with granular plugins

### Composability

- Mix and match plugins for complex workflows
- Workflow orchestrators compose focused plugins
- Clear boundaries between plugins
- No forced feature bundling

## See Also

- [Agent Skills](./agent-skills.md) - 181 specialized skills across plugins
- [Agent Reference](./agents.md) - Complete agent catalog
- [Usage Guide](./usage.md) - Commands and workflows
- [Architecture](./architecture.md) - Design principles

---

## File: docs/usage.md

# Usage Guide

Complete guide to using agents, slash commands, and multi-agent workflows.

## Overview

The plugin ecosystem provides two primary interfaces:

1. **Slash Commands** - Direct invocation of tools and workflows
2. **Natural Language** - Claude reasons about which agents to use

## How Installation Actually Works

The **plugin** is the unit of installation; skills and agents come along with it.

1. `/plugin marketplace add wshobson/agents` registers the catalog. It loads
   nothing into context.
2. `/plugin install ` installs one plugin — its agents, commands, and
   skills together. Install the 2–3 plugins that cover your domain, not
   individual skills.
3. **Auto-discovery operates inside what you installed.** Claude Code discovers
   an installed plugin's skills automatically and activates them when your task
   matches a skill's description. You never select skills by hand.
4. `AGENTS.md` and the `docs/` catalogs are for browsing what exists; reading
   them installs nothing.

## Slash Commands

Slash commands are the primary interface for working with agents and workflows. Each plugin provides namespaced commands that you can run directly.

### Command Format

```bash
/plugin-name:command-name [arguments]
```

### Discovering Commands

List all available slash commands from installed plugins:

```bash
/plugin
```

### Benefits of Slash Commands

- **Direct invocation** - No need to describe what you want in natural language
- **Structured arguments** - Pass parameters explicitly for precise control
- **Composability** - Chain commands together for complex workflows
- **Discoverability** - Use `/plugin` to see all available commands

## Natural Language

Agents can also be invoked through natural language when you need Claude to reason about which specialist to use:

```
"Use backend-architect to design the authentication API"
"Have security-auditor scan for OWASP vulnerabilities"
"Get performance-engineer to optimize this database query"
```

Claude Code automatically selects and coordinates the appropriate agents based on your request.

## Command Reference by Category

### Development & Features

| Command                                        | Description                                 |
| ---------------------------------------------- | ------------------------------------------- |
| `/backend-development:feature-development`     | End-to-end backend feature development      |
| `/full-stack-orchestration:full-stack-feature` | Complete full-stack feature implementation  |
| `/multi-platform-apps:multi-platform`          | Cross-platform app development coordination |

### Testing & Quality

| Command                       | Description                           |
| ----------------------------- | ------------------------------------- |
| `/unit-testing:test-generate` | Generate comprehensive unit tests     |
| `/tdd-workflows:tdd-cycle`    | Complete TDD red-green-refactor cycle |
| `/tdd-workflows:tdd-red`      | Write failing tests first             |
| `/tdd-workflows:tdd-green`    | Implement code to pass tests          |
| `/tdd-workflows:tdd-refactor` | Refactor with passing tests           |

### Code Quality & Review

| Command                             | Description                |
| ----------------------------------- | -------------------------- |
| `/comprehensive-review:full-review` | Multi-perspective analysis |
| `/comprehensive-review:pr-enhance`  | Enhance pull requests      |

### Debugging & Troubleshooting

| Command                                | Description                    |
| -------------------------------------- | ------------------------------ |
| `/debugging-toolkit:smart-debug`       | Interactive smart debugging    |
| `/incident-response:incident-response` | Production incident management |
| `/incident-response:smart-fix`         | Automated incident resolution  |
| `/error-debugging:error-analysis`      | Deep error analysis            |
| `/error-debugging:error-trace`         | Stack trace debugging          |
| `/error-diagnostics:smart-debug`       | Smart diagnostic debugging     |
| `/distributed-debugging:debug-trace`   | Distributed system tracing     |

### Security

| Command                                    | Description                         |
| ------------------------------------------ | ----------------------------------- |
| `/security-scanning:security-hardening`    | Comprehensive security hardening    |
| `/security-scanning:security-sast`         | Static application security testing |
| `/security-scanning:security-dependencies` | Dependency vulnerability scanning   |
| `/security-compliance:compliance-check`    | SOC2/HIPAA/GDPR compliance          |
| `/frontend-mobile-security:xss-scan`       | XSS vulnerability scanning          |

### Infrastructure & Deployment

| Command                                   | Description                     |
| ----------------------------------------- | ------------------------------- |
| `/observability-monitoring:monitor-setup` | Setup monitoring infrastructure |
| `/observability-monitoring:slo-implement` | Implement SLO/SLI metrics       |
| `/deployment-validation:config-validate`  | Pre-deployment validation       |
| `/cicd-automation:workflow-automate`      | CI/CD pipeline automation       |

### Data & ML

| Command                                 | Description                        |
| --------------------------------------- | ---------------------------------- |
| `/machine-learning-ops:ml-pipeline`     | ML training pipeline orchestration |
| `/data-engineering:data-pipeline`       | ETL/ELT pipeline construction      |
| `/data-engineering:data-driven-feature` | Data-driven feature development    |
| `/dgx-spark-ops:spark-preflight`        | DGX Spark ML workload preflight with env-report.json |

### Documentation

| Command                                  | Description                                                                                |
| ---------------------------------------- | ------------------------------------------------------------------------------------------ |
| `/code-documentation:doc-generate`       | Generate comprehensive documentation                                                       |
| `/code-documentation:code-explain`       | Explain code functionality                                                                 |
| `/documentation-generation:doc-generate` | OpenAPI specs, diagrams, tutorials                                                         |
| `/c4-architecture:c4-architecture`       | Generate comprehensive C4 architecture documentation (Context, Container, Component, Code) |

### Refactoring & Maintenance

| Command                                 | Description                  |
| --------------------------------------- | ---------------------------- |
| `/code-refactoring:refactor-clean`      | Code cleanup and refactoring |
| `/code-refactoring:tech-debt`           | Technical debt management    |
| `/codebase-cleanup:deps-audit`          | Dependency auditing          |
| `/codebase-cleanup:tech-debt`           | Technical debt reduction     |
| `/framework-migration:legacy-modernize` | Legacy code modernization    |
| `/framework-migration:code-migrate`     | Framework migration          |
| `/framework-migration:deps-upgrade`     | Dependency upgrades          |

### Database

| Command                                        | Description                     |
| ---------------------------------------------- | ------------------------------- |
| `/database-migrations:sql-migrations`          | SQL migration automation        |
| `/database-migrations:migration-observability` | Migration monitoring            |
| `/database-cloud-optimization:cost-optimize`   | Database and cloud optimization |

### Git & PR Workflows

| Command                          | Description                  |
| -------------------------------- | ---------------------------- |
| `/git-pr-workflows:pr-enhance`   | Enhance pull request quality |
| `/git-pr-workflows:onboard`      | Team onboarding automation   |
| `/git-pr-workflows:git-workflow` | Git workflow automation      |

### Project Scaffolding

| Command                                      | Description                  |
| -------------------------------------------- | ---------------------------- |
| `/python-development:python-scaffold`        | FastAPI/Django project setup |
| `/javascript-typescript:typescript-scaffold` | Next.js/React + Vite setup   |
| `/systems-programming:rust-project`          | Rust project scaffolding     |

### AI & LLM Development

| Command                                     | Description                     |
| ------------------------------------------- | ------------------------------- |
| `/llm-application-dev:langchain-agent`      | LangChain agent development     |
| `/llm-application-dev:ai-assistant`         | AI assistant implementation     |
| `/llm-application-dev:prompt-optimize`      | Prompt engineering optimization |
| `/agent-orchestration:multi-agent-optimize` | Multi-agent optimization        |
| `/agent-orchestration:improve-agent`        | Agent improvement workflows     |
| `/llm-finetuning:finetune`                  | Eval-gated fine-tuning lifecycle end to end |
| `/llm-finetuning:promote-checkpoint`        | Re-gate and export a fine-tuned checkpoint  |

### Testing & Performance

| Command                                             | Description          |
| --------------------------------------------------- | -------------------- |
| `/performance-testing-review:ai-review`             | Performance analysis |
| `/application-performance:performance-optimization` | App optimization     |

### Team Collaboration

| Command                             | Description                 |
| ----------------------------------- | --------------------------- |
| `/team-collaboration:issue`         | Issue management automation |
| `/team-collaboration:standup-notes` | Standup notes generation    |

### Accessibility

| Command                                         | Description              |
| ----------------------------------------------- | ------------------------ |
| `/accessibility-compliance:accessibility-audit` | WCAG compliance auditing |

### API Development

| Command                               | Description             |
| ------------------------------------- | ----------------------- |
| `/api-testing-observability:api-mock` | API mocking and testing |

### Context Management

| Command                               | Description               |
| ------------------------------------- | ------------------------- |
| `/context-management:context-save`    | Save conversation context |
| `/context-management:context-restore` | Restore previous context  |

## Multi-Agent Workflow Examples

Plugins provide pre-configured multi-agent workflows accessible via slash commands.

### Full-Stack Development

```bash
# Command-based workflow invocation
/full-stack-orchestration:full-stack-feature "user dashboard with real-time analytics"

# Natural language alternative
"Implement user dashboard with real-time analytics"
```

**Orchestration:** backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer

**What happens:**

1. Database schema design with migrations
2. Backend API implementation (REST/GraphQL)
3. Frontend components with state management
4. Comprehensive test suite (unit/integration/E2E)
5. Security audit and hardening
6. CI/CD pipeline setup with feature flags
7. Observability and monitoring configuration

### Security Hardening

```bash
# Comprehensive security assessment and remediation
/security-scanning:security-hardening --level comprehensive

# Natural language alternative
"Perform security audit and implement OWASP best practices"
```

**Orchestration:** security-auditor → backend-security-coder → frontend-security-coder → mobile-security-coder → test-automator

### Data/ML Pipeline

```bash
# ML feature development with production deployment
/machine-learning-ops:ml-pipeline "customer churn prediction model"

# Natural language alternative
"Build customer churn prediction model with deployment"
```

**Orchestration:** data-scientist → data-engineer → ml-engineer → mlops-engineer → performance-engineer

### Incident Response

```bash
# Smart debugging with root cause analysis
/incident-response:smart-fix "production memory leak in payment service"

# Natural language alternative
"Debug production memory leak and create runbook"
```

**Orchestration:** incident-responder → devops-troubleshooter → debugger → error-detective → observability-engineer

### C4 Architecture Documentation

```bash
# Generate comprehensive C4 architecture documentation
/c4-architecture:c4-architecture

# Natural language alternative
"Create C4 architecture documentation for this codebase"
```

**Orchestration:** c4-code → c4-component → c4-container → c4-context

**What happens:**

1. **Code Level**: Bottom-up analysis of all subdirectories, creating code-level documentation with function signatures and dependencies
2. **Component Level**: Synthesizes code documentation into logical components with interfaces and relationships
3. **Container Level**: Maps components to deployment containers with OpenAPI/Swagger API specifications
4. **Context Level**: Creates high-level system context with personas, user journeys, and external dependencies

**Output:** Complete C4 documentation in `C4-Documentation/` directory with Mermaid diagrams at all levels (Context, Container, Component, Code)

## Command Arguments and Options

Many slash commands support arguments for precise control:

```bash
# Test generation for specific files
/unit-testing:test-generate src/api/users.py

# Feature development with methodology specification
/backend-development:feature-development OAuth2 integration with social login

# Security dependency scanning
/security-scanning:security-dependencies

# Component scaffolding
/frontend-mobile-development:component-scaffold UserProfile component with hooks

# TDD workflow cycle
/tdd-workflows:tdd-red User can reset password
/tdd-workflows:tdd-green
/tdd-workflows:tdd-refactor

# Smart debugging
/debugging-toolkit:smart-debug memory leak in checkout flow

# Python project scaffolding
/python-development:python-scaffold fastapi-microservice

# C4 architecture documentation generation
/c4-architecture:c4-architecture
```

## Combining Natural Language and Commands

You can mix both approaches for optimal flexibility:

```
# Start with a command for structured workflow
/full-stack-orchestration:full-stack-feature "payment processing"

# Then provide natural language guidance
"Ensure PCI-DSS compliance and integrate with Stripe"
"Add retry logic for failed transactions"
"Set up fraud detection rules"
```

## Best Practices

### When to Use Slash Commands

- **Structured workflows** - Multi-step processes with clear phases
- **Repetitive tasks** - Operations you perform frequently
- **Precise control** - When you need specific parameters
- **Discovery** - Exploring available functionality

### When to Use Natural Language

- **Exploratory work** - When you're not sure which tool to use
- **Complex reasoning** - When Claude needs to coordinate multiple agents
- **Contextual decisions** - When the right approach depends on the situation
- **Ad-hoc tasks** - One-off operations that don't fit a command

### Workflow Composition

Compose multiple plugins for complex scenarios:

```bash
# 1. Start with feature development
/backend-development:feature-development payment processing API

# 2. Add security hardening
/security-scanning:security-hardening

# 3. Generate comprehensive tests
/unit-testing:test-generate

# 4. Review the implementation
/comprehensive-review:full-review

# 5. Set up CI/CD
/cicd-automation:workflow-automate

# 6. Add monitoring
/observability-monitoring:monitor-setup
```

## Agent Skills Integration

Agent Skills work alongside commands to provide deep expertise:

```
User: "Set up FastAPI project with async patterns"
→ Activates: fastapi-templates skill
→ Invokes: /python-development:python-scaffold
→ Result: Production-ready FastAPI project with best practices

User: "Implement Kubernetes deployment with Helm"
→ Activates: helm-chart-scaffolding, k8s-manifest-generator skills
→ Guides: kubernetes-architect agent
→ Result: Production-grade K8s manifests with Helm charts
```

See [Agent Skills](./agent-skills.md) for details on the 181 specialized skills.

## See Also

- [Agent Skills](./agent-skills.md) - Specialized knowledge packages
- [Agent Reference](./agents.md) - Complete agent catalog
- [Plugin Reference](./plugins.md) - All 92 marketplace plugins
- [Architecture](./architecture.md) - Design principles

---

## File: plugins/ui-design/README.md

# UI/UX Design Plugin for Claude Code

Comprehensive UI/UX design plugin covering mobile (iOS, Android, React Native) and web applications with modern design patterns, accessibility, and design systems.

## Features

### Core Capabilities

- **Design Systems**: Token architecture, theming, multi-brand systems
- **Accessibility**: WCAG 2.2 compliance, inclusive design patterns
- **Responsive Design**: Container queries, fluid layouts, breakpoints
- **Mobile Design**: iOS HIG, Material Design 3, React Native patterns
- **Web Components**: React/Vue/Svelte patterns, CSS-in-JS
- **Interaction Design**: Microinteractions, motion, transitions

## Skills

| Skill                       | Description                                      |
| --------------------------- | ------------------------------------------------ |
| `design-system-patterns`    | Design tokens, theming, component architecture   |
| `accessibility-compliance`  | WCAG 2.2, mobile a11y, inclusive design          |
| `responsive-design`         | Container queries, fluid layouts, breakpoints    |
| `mobile-ios-design`         | iOS Human Interface Guidelines, SwiftUI patterns |
| `mobile-android-design`     | Material Design 3, Jetpack Compose patterns      |
| `react-native-design`       | React Native styling, navigation, animations     |
| `web-component-design`      | React/Vue/Svelte component patterns, CSS-in-JS   |
| `interaction-design`        | Microinteractions, motion design, transitions    |
| `visual-design-foundations` | Typography, color theory, spacing, iconography   |

## Agents

| Agent                     | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| `ui-designer`             | Proactive UI design, component creation, layout optimization |
| `accessibility-expert`    | A11y analysis, WCAG compliance, remediation                  |
| `design-system-architect` | Design token systems, component libraries, theming           |

## Commands

| Command                          | Description                                    |
| -------------------------------- | ---------------------------------------------- |
| `/ui-design:design-review`       | Review existing UI for issues and improvements |
| `/ui-design:create-component`    | Guided component creation with proper patterns |
| `/ui-design:accessibility-audit` | Audit UI code for WCAG compliance              |
| `/ui-design:design-system-setup` | Initialize a design system with tokens         |

## Installation

```bash
/plugin install ui-design
```

## Usage Examples

### Design Review

```
/ui-design:design-review --file src/components/Button.tsx
```

### Create Component

```
/ui-design:create-component Card --platform react
```

### Accessibility Audit

```
/ui-design:accessibility-audit --level AA
```

### Design System Setup

```
/ui-design:design-system-setup --name "Acme Design System"
```

## Key Technologies Covered

### Web

- CSS Grid, Flexbox, Container Queries
- Tailwind CSS, CSS-in-JS (Styled Components, Emotion)
- React, Vue, Svelte component patterns
- Framer Motion, GSAP animations

### Mobile

- **iOS**: SwiftUI, UIKit, Human Interface Guidelines
- **Android**: Jetpack Compose, Material Design 3
- **React Native**: StyleSheet, Reanimated, React Navigation

### Design Systems

- Design tokens (Style Dictionary, Figma Variables)
- Component libraries (Storybook documentation)
- Multi-brand theming

### Accessibility

- WCAG 2.2 AA/AAA compliance
- ARIA patterns and semantic HTML
- Screen reader compatibility
- Keyboard navigation

## Generated Artifacts

The plugin creates artifacts in `.ui-design/`:

```
.ui-design/
├── design-system.config.json    # Design system configuration
├── component_specs/             # Generated component specifications
├── audit_reports/               # Accessibility audit reports
└── tokens/                      # Generated design tokens
```

## Requirements

- Claude Code CLI
- Node.js 18+ (for design token generation)

## License

MIT License

---

## File: plugins/startup-business-analyst/README.md

# Startup Business Analyst Plugin

Comprehensive business analysis plugin specialized for early-stage startups, providing market sizing, financial modeling, team planning, and strategic research capabilities.

## Overview

This plugin equips Claude with expert-level startup business analysis capabilities, focusing on the critical calculations and strategic insights needed by entrepreneurs, founders, and investors.

## Features

### 5 Specialized Skills

- **market-sizing-analysis** - TAM/SAM/SOM calculations with multiple methodologies
- **startup-financial-modeling** - 3-5 year financial projections with scenarios
- **team-composition-analysis** - Organizational design and compensation planning
- **competitive-landscape** - Market positioning and competitive strategy
- **startup-metrics-framework** - Key metrics for different business models

### 3 Interactive Commands

- `/startup-business-analyst:market-opportunity` - Generate market opportunity analysis
- `/startup-business-analyst:financial-projections` - Create financial models with scenarios
- `/startup-business-analyst:business-case` - Generate comprehensive business case documents

### 1 Expert Agent

- **startup-analyst** - Specialized agent for early-stage startup analysis

## Installation

```bash
/plugin install startup-business-analyst@claude-code-workflows
```

## Usage

### Automatic Skill Activation

Skills activate automatically based on your questions:

```
"What's the TAM for a B2B SaaS project management tool?"
→ Activates market-sizing-analysis skill

"Create a 3-year financial model for my marketplace startup"
→ Activates startup-financial-modeling skill

"What are the key SaaS metrics I should track?"
→ Activates startup-metrics-framework skill
```

### Commands

**Market Opportunity Analysis:**

```bash
/startup-business-analyst:market-opportunity
```

Generates comprehensive market sizing with TAM/SAM/SOM breakdown.

**Financial Projections:**

```bash
/startup-business-analyst:financial-projections
```

Creates 3-scenario financial model with revenue, costs, and runway.

**Business Case:**

```bash
/startup-business-analyst:business-case
```

Produces investor-ready business case document.

### Agent Usage

The startup-analyst agent triggers automatically for business-related questions:

```
"Help me analyze the competitive landscape for my fintech startup"
"What should my team structure look like at $1M ARR?"
"Calculate my customer acquisition payback period"
```

## Skills Reference

### Market Sizing Analysis

Covers three methodologies:

- **Top-down**: Industry reports and market research
- **Bottom-up**: Customer segment calculations
- **Value theory**: Problem value and willingness to pay

Includes templates for SaaS, marketplace, consumer, B2B, and fintech.

### Startup Financial Modeling

Components:

- Revenue projections (by customer segment)
- Cost structure (COGS, S&M, R&D, G&A)
- Cash flow and runway calculations
- Headcount planning
- Scenario analysis (conservative, base, optimistic)

### Team Composition Analysis

Covers:

- Role-by-stage recommendations
- Compensation benchmarks (US-focused)
- Equity/options allocation strategies
- Full-time vs. contractor decisions
- Organizational design

### Competitive Landscape

Frameworks:

- Porter's Five Forces
- Blue Ocean Strategy
- Positioning maps
- Go-to-market strategy
- Competitive pricing analysis

### Startup Metrics Framework

Business model coverage:

- **SaaS**: ARR, MRR, NRR, CAC, LTV, Magic Number
- **Marketplace**: GMV, Take Rate, Liquidity
- **Consumer**: DAU/MAU, Retention, Virality
- **B2B**: ACR, Win Rate, Sales Cycle
- **Fintech**: TPV, Monetization Rate, Fraud Rate

## Examples

### Example 1: TAM/SAM/SOM Calculation

```markdown
"Calculate TAM/SAM/SOM for an AI-powered email marketing tool for e-commerce"

→ Skill activates and provides:

- TAM: Total email marketing software market
- SAM: AI-powered tools for e-commerce segment
- SOM: Realistic 3-5 year capture
- Methodology explanation
- Market growth assumptions
- Data sources and citations
```

### Example 2: Financial Model

```markdown
"Create a 3-year financial model for a SaaS product with $50/mo pricing"

→ Command generates:

- Revenue by cohort
- Cost structure breakdown
- Headcount plan
- Cash flow projection
- Runway calculation
- 3 scenarios (conservative/base/optimistic)
```

### Example 3: Competitive Analysis

```markdown
"Analyze competitors in the project management software space"

→ Agent provides:

- Competitive landscape map
- Feature comparison matrix
- Pricing analysis
- Market positioning recommendations
- Differentiation opportunities
```

## Best Practices

1. **Provide Context**: Share your business model, target market, and stage
2. **Be Specific**: Include numbers, timeframes, and assumptions where possible
3. **Iterate**: Start with high-level analysis, then drill into details
4. **Validate Assumptions**: Question and refine assumptions with the agent
5. **Cite Sources**: Ask for data sources and validation methods

## Requirements

- Claude Code CLI
- Internet access (for web research capabilities)
- No external dependencies

## Model Configuration

- **Agent Model**: `inherit` (uses your session default model)
- **Recommended**: Sonnet for balance of speed and quality
- **Use Opus for**: Complex multi-market analysis or detailed financial models

## Contributing

Found an issue or have suggestions? Please open an issue or PR at:
https://github.com/wshobson/agents

## License

MIT License - see repository LICENSE file for details.

## Version History

- **1.0.0** (2026-01-13): Initial release
  - 5 specialized skills
  - 3 interactive commands
  - 1 expert agent
  - Comprehensive startup analysis capabilities

---

## File: plugins/llm-application-dev/README.md

# LLM Application Development Plugin for Claude Code

Build production-ready LLM applications, advanced RAG systems, and intelligent agents with modern AI patterns.

## Version 2.0.0 Highlights

- **LangGraph Integration**: Updated from deprecated LangChain patterns to LangGraph StateGraph workflows
- **Modern Model Support**: Claude Opus 4.8/Sonnet 5/Haiku 4.5 and GPT-5.4/GPT-5-mini
- **Voyage AI Embeddings**: Recommended embedding models for Claude applications
- **Structured Outputs**: Pydantic-based structured output patterns

## Features

### Core Capabilities

- **RAG Systems**: Production retrieval-augmented generation with hybrid search
- **Vector Search**: Pinecone, Qdrant, Weaviate, Milvus, pgvector optimization
- **Agent Architectures**: LangGraph-based agents with memory and tool use
- **Prompt Engineering**: Advanced prompting techniques with model-specific optimization

### Key Technologies

- LangChain 1.x / LangGraph for agent workflows
- Voyage AI, OpenAI, and open-source embedding models
- HNSW, IVF, and Product Quantization index strategies
- Async patterns with checkpointers for durable execution

## Agents

| Agent                      | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| `ai-engineer`              | Production-grade LLM applications, RAG systems, and agent architectures    |
| `prompt-engineer`          | Advanced prompting techniques, constitutional AI, and model optimization   |
| `vector-database-engineer` | Vector search implementation, embedding strategies, and semantic retrieval |

## Skills

| Skill                          | Description                                                 |
| ------------------------------ | ----------------------------------------------------------- |
| `langchain-architecture`       | LangGraph StateGraph patterns, memory, and tool integration |
| `rag-implementation`           | RAG systems with hybrid search and reranking                |
| `llm-evaluation`               | Evaluation frameworks for LLM applications                  |
| `prompt-engineering-patterns`  | Chain-of-thought, few-shot, and structured outputs          |
| `embedding-strategies`         | Embedding model selection and optimization                  |
| `similarity-search-patterns`   | Vector similarity search implementation                     |
| `vector-index-tuning`          | HNSW, IVF, and quantization optimization                    |
| `hybrid-search-implementation` | Vector + keyword search fusion                              |

## Commands

| Command                                | Description                     |
| -------------------------------------- | ------------------------------- |
| `/llm-application-dev:langchain-agent` | Create LangGraph-based agent    |
| `/llm-application-dev:ai-assistant`    | Build AI assistant application  |
| `/llm-application-dev:prompt-optimize` | Optimize prompts for production |

## Installation

```bash
/plugin install llm-application-dev
```

## Requirements

- LangChain >= 1.2.0
- LangGraph >= 0.3.0
- Python 3.11+

## Changelog

### 2.0.0 (January 2026)

- **Breaking**: Migrated from LangChain 0.x to LangChain 1.x/LangGraph
- **Breaking**: Updated model references to Claude 4.6 and GPT-5.4
- Added Voyage AI as primary embedding recommendation for Claude apps
- Added LangGraph StateGraph patterns replacing deprecated `initialize_agent()`
- Added structured outputs with Pydantic
- Added async patterns with checkpointers
- Fixed security issue: replaced unsafe code execution with AST-based safe math evaluation
- Updated hybrid search with modern Pinecone client API

### 1.2.2

- Minor bug fixes and documentation updates

## License

MIT License - See the plugin configuration for details.

---

## File: plugins/dotnet-contribution/README.md

# .NET Backend Development Plugin

A comprehensive plugin for .NET backend development with C#, ASP.NET Core, Entity Framework Core, and Dapper.

## Overview

This plugin provides agents, skills, and patterns for building production-grade .NET applications. It focuses on modern C# (12/13), ASP.NET Core 8+, and enterprise development patterns.

## Contents

### Agents

| Agent              | Model  | Description                                                                        |
| ------------------ | ------ | ---------------------------------------------------------------------------------- |
| `dotnet-architect` | Sonnet | Expert .NET architect for API development, code review, and architecture decisions |

### Skills

| Skill                     | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| `dotnet-backend-patterns` | Comprehensive patterns for services, repositories, DI, caching, and testing |

### Assets

- `service-template.cs` - Complete service implementation with Result pattern, validation, caching
- `repository-template.cs` - Repository implementations with Dapper and EF Core

### References

- `ef-core-best-practices.md` - EF Core optimization guide
- `dapper-patterns.md` - Advanced Dapper usage patterns

## Usage

### With Claude Code CLI

```bash
# General .NET architecture help
claude -p "Act as dotnet-architect and design a caching strategy for my product catalog"

# Code review
claude -p "Act as dotnet-architect and review this async code for issues"

# Implementation help
claude -p "Use dotnet-backend-patterns skill to implement a repository with Dapper"
```

### Example Prompts

1. **API Design**

   ```
   Act as dotnet-architect. Design a REST API for order management with proper
   DTOs, validation, and error handling.
   ```

2. **Performance Review**

   ```
   Act as dotnet-architect. Review this EF Core query for N+1 problems and
   suggest optimizations.
   ```

3. **Architecture Decision**
   ```
   Act as dotnet-architect. Should I use EF Core or Dapper for this high-throughput
   read scenario? Explain trade-offs.
   ```

## Topics Covered

### C# Language

- Async/await patterns and pitfalls
- LINQ optimization
- Records and immutability
- Pattern matching
- Nullable reference types
- Memory-efficient programming

### ASP.NET Core

- Minimal APIs and Controllers
- Dependency Injection (Scoped, Singleton, Transient, Keyed)
- Configuration with IOptions
- Middleware pipeline
- Authentication/Authorization
- Health checks

### Data Access

- Entity Framework Core best practices
- Dapper for high-performance queries
- Repository pattern
- Unit of Work
- Connection management
- Transaction handling

### Caching

- IMemoryCache
- IDistributedCache with Redis
- Multi-level caching
- Cache invalidation
- Distributed locking

### Testing

- xUnit fundamentals
- Moq for mocking
- Integration tests with WebApplicationFactory
- Test patterns and best practices

## Stack Compatibility

| Technology            | Version |
| --------------------- | ------- |
| .NET                  | 8.0+    |
| C#                    | 12+     |
| ASP.NET Core          | 8.0+    |
| Entity Framework Core | 8.0+    |
| SQL Server            | 2019+   |
| Redis                 | 6.0+    |

## Contributing

Contributions welcome! Please ensure:

- Code examples compile and follow C# conventions
- Patterns are production-tested
- Documentation is clear and includes examples

## License

MIT License - See repository root for details.

## 2. Official Technical Reference & Guides (wshobson/wshobson.github.io)

# Seth Hobson

> Seth Hobson is a software engineer with 15+ years of experience in applied AI, data engineering, and distributed systems. He is the founder of Major 7 Apps, creator of the wshobson/agents plugin marketplace, and author of the AI Primitives newsletter.

Currently Senior AI Engineer at United Data Technologies; previously senior software engineer at Apple (2015–2021) and Kuali (2021–2023).

## Links

- [sethhobson.com](https://sethhobson.com/): personal site (this site)
- [GitHub](https://github.com/wshobson): open-source work
- [Major 7 Apps](https://major7apps.com/): product studio — hub linking to all current applications
- [AI Primitives](https://primitivesai.substack.com/): weekly newsletter on applied AI, agentic systems, and engineering primitives
- [LinkedIn](https://www.linkedin.com/in/wshobson): professional profile

## Projects

- [agents](https://github.com/wshobson/agents): agentic plugin marketplace — 82 plugins, 191 agents, 155 skills, 102 commands, shipped to five harnesses (Claude Code, Codex CLI, Cursor, OpenCode, Gemini CLI)
- [commands](https://github.com/wshobson/commands): 52 multi-agent orchestration slash commands for Claude Code
- [Capital Companion](https://capitalcompanion.ai): AI-powered trading insights, stock analysis, and risk management
- [Pensyve](https://github.com/major7apps/pensyve): universal memory runtime for AI agents — episodic/semantic/procedural memory, 8-signal fusion retrieval, FSRS forgetting
- [Maverick MCP](https://github.com/wshobson/maverick-mcp): personal stock-analysis MCP server
- [Tiingo MCP](https://github.com/wshobson/tiingo-mcp): production-grade MCP server for the Tiingo financial data API, 17 tools, on PyPI