feat: add claude-code-setup and claude-md-management plugins

2026-01-31 20:03:36 +00:00 · 2026-01-16 14:34:43 -08:00
parent 9627620588
commit a86e34672c
19 changed files with 2262 additions and 0 deletions
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/SKILL.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/SKILL.md
@@ -0,0 +1,287 @@
+---
+name: claude-automation-recommender
+description: Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, slash commands, plugins, MCP servers). Use when user asks for automation recommendations, wants to optimize their Claude Code setup, mentions improving Claude Code workflows, asks how to first set up Claude Code for a project, or wants to know what Claude Code features they should use.
+tools: Read, Glob, Grep, Bash
+---
+
+# Claude Automation Recommender
+
+Analyze codebase patterns to recommend tailored Claude Code automations across all extensibility options.
+
+**This skill is read-only.** It analyzes the codebase and outputs recommendations. It does NOT create or modify any files. Users implement the recommendations themselves or ask Claude separately to help build them.
+
+## Output Guidelines
+
+- **Recommend 1-2 of each type**: Don't overwhelm - surface the top 1-2 most valuable automations per category
+- **If user asks for a specific type**: Focus only on that type and provide more options (3-5 recommendations)
+- **Tell users they can ask for more**: End by noting they can request more recommendations for any specific category
+
+## Automation Types Overview
+
+| Type | Best For |
+|------|----------|
+| **Hooks** | Automatic actions on tool events (format on save, lint, block edits) |
+| **Subagents** | Specialized reviewers/analyzers that run in parallel |
+| **Skills** | Packaged expertise with workflows and reference material |
+| **Slash Commands** | Quick, repeatable prompts with arguments |
+| **Plugins** | Collections of skills that can be installed |
+| **MCP Servers** | External tool integrations (databases, APIs, browsers, docs) |
+
+## Workflow
+
+### Phase 1: Codebase Analysis
+
+Gather project context:
+
+```bash
+# Detect project type and tools
+ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
+cat package.json 2>/dev/null | head -50
+
+# Check dependencies for MCP server recommendations
+cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|stripe)"'
+
+# Check for existing Claude Code config
+ls -la .claude/ CLAUDE.md 2>/dev/null
+
+# Analyze project structure
+ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null
+```
+
+**Key Indicators to Capture:**
+
+| Category | What to Look For | Informs Recommendations For |
+|----------|------------------|----------------------------|
+| Language/Framework | package.json, pyproject.toml, import patterns | Hooks, MCP servers |
+| Frontend stack | React, Vue, Angular, Next.js | Playwright MCP, frontend skills |
+| Backend stack | Express, FastAPI, Django | API documentation tools |
+| Database | Prisma, Supabase, raw SQL | Database MCP servers |
+| External APIs | Stripe, OpenAI, AWS SDKs | context7 MCP for docs |
+| Testing | Jest, pytest, Playwright configs | Testing hooks, subagents |
+| CI/CD | GitHub Actions, CircleCI | GitHub MCP server |
+| Issue tracking | Linear, Jira references | Issue tracker MCP |
+| Docs patterns | OpenAPI, JSDoc, docstrings | Documentation skills |
+
+### Phase 2: Generate Recommendations
+
+Based on analysis, generate recommendations across all categories:
+
+#### A. MCP Server Recommendations
+
+See [references/mcp-servers.md](references/mcp-servers.md) for detailed patterns.
+
+| Codebase Signal | Recommended MCP Server |
+|-----------------|------------------------|
+| Uses popular libraries (React, Express, etc.) | **context7** - Live documentation lookup |
+| Frontend with UI testing needs | **Playwright** - Browser automation/testing |
+| Uses Supabase | **Supabase MCP** - Direct database operations |
+| PostgreSQL/MySQL database | **Database MCP** - Query and schema tools |
+| GitHub repository | **GitHub MCP** - Issues, PRs, actions |
+| Uses Linear for issues | **Linear MCP** - Issue management |
+| AWS infrastructure | **AWS MCP** - Cloud resource management |
+| Slack workspace | **Slack MCP** - Team notifications |
+| Memory/context persistence | **Memory MCP** - Cross-session memory |
+| Sentry error tracking | **Sentry MCP** - Error investigation |
+| Docker containers | **Docker MCP** - Container management |
+
+#### B. Skills Recommendations
+
+See [references/skills-reference.md](references/skills-reference.md) for patterns.
+
+| Codebase Signal | Recommended Skill |
+|-----------------|-------------------|
+| Complex implementation tasks | **Plan agent** - Architecture planning |
+| Large codebase | **Explore agent** - Codebase navigation |
+| Creates documents | **docx skill** - Word document generation |
+| Creates spreadsheets | **xlsx skill** - Excel creation |
+| Creates presentations | **pptx skill** - PowerPoint generation |
+| PDF workflows | **pdf skill** - PDF manipulation |
+| Frontend UI work | **frontend-design** - UI component design |
+| Needs custom Claude tools | **mcp-builder** - Build MCP servers |
+| Wants branded output | **brand-guidelines** - Apply brand styling |
+| Testing web apps | **webapp-testing** - Playwright testing |
+
+#### C. Hooks Recommendations
+
+See [references/hooks-patterns.md](references/hooks-patterns.md) for configurations.
+
+| Codebase Signal | Recommended Hook |
+|-----------------|------------------|
+| Prettier configured | PostToolUse: auto-format on edit |
+| ESLint/Ruff configured | PostToolUse: auto-lint on edit |
+| TypeScript project | PostToolUse: type-check on edit |
+| Tests directory exists | PostToolUse: run related tests |
+| `.env` files present | PreToolUse: block `.env` edits |
+| Lock files present | PreToolUse: block lock file edits |
+| Security-sensitive code | PreToolUse: require confirmation |
+
+#### D. Subagent Recommendations
+
+See [references/subagent-templates.md](references/subagent-templates.md) for templates.
+
+| Codebase Signal | Recommended Subagent |
+|-----------------|---------------------|
+| Large codebase (>500 files) | **code-reviewer** - Parallel code review |
+| Auth/payments code | **security-reviewer** - Security audits |
+| API project | **api-documenter** - OpenAPI generation |
+| Performance critical | **performance-analyzer** - Bottleneck detection |
+| Frontend heavy | **ui-reviewer** - Accessibility review |
+| Needs more tests | **test-writer** - Test generation |
+
+#### E. Slash Command Recommendations
+
+See [references/slash-command-examples.md](references/slash-command-examples.md) for templates.
+
+| Codebase Signal | Recommended Command |
+|-----------------|---------------------|
+| Git-based workflow | `/pr-review` - Review PR changes |
+| Test suite exists | `/test [file]` - Run specific tests |
+| CI/CD configured | `/ci-fix` - Debug CI failures |
+| Changelog file | `/changelog` - Update changelog |
+| API routes | `/api-doc [route]` - Document endpoint |
+| Complex codebase | `/explain [file]` - Explain code |
+
+#### F. Plugin Recommendations
+
+See [references/plugins-reference.md](references/plugins-reference.md) for available plugins.
+
+| Codebase Signal | Recommended Plugin |
+|-----------------|-------------------|
+| General productivity | **anthropic-agent-skills** - Core skills bundle |
+| Document workflows | Install docx, xlsx, pdf skills |
+| Frontend development | **frontend-design** plugin |
+| Building AI tools | **mcp-builder** for MCP development |
+
+### Phase 3: Output Recommendations Report
+
+Format recommendations clearly. **Only include 1-2 recommendations per category** - the most valuable ones for this specific codebase. Skip categories that aren't relevant.
+
+```markdown
+## Claude Code Automation Recommendations
+
+I've analyzed your codebase and identified the top automations for each category. Here are my top 1-2 recommendations per type:
+
+### Codebase Profile
+- **Type**: [detected language/runtime]
+- **Framework**: [detected framework]
+- **Key Libraries**: [relevant libraries detected]
+
+---
+
+### 🔌 MCP Servers
+
+#### context7
+**Why**: [specific reason based on detected libraries]
+**Install**: `claude mcp add context7`
+
+---
+
+### 🎯 Skills
+
+#### [skill name]
+**Why**: [specific reason]
+**How**: [invocation method]
+
+---
+
+### ⚡ Hooks
+
+#### [hook name]
+**Why**: [specific reason based on detected config]
+**Where**: `.claude/settings.json`
+
+---
+
+### 🤖 Subagents
+
+#### [agent name]
+**Why**: [specific reason based on codebase patterns]
+**Where**: `.claude/agents/[name].md`
+
+---
+
+### 📝 Slash Commands
+
+#### /[command]
+**Why**: [specific reason]
+**Where**: `.claude/commands/[name].md`
+
+---
+
+**Want more?** Ask for additional recommendations for any specific category (e.g., "show me more MCP server options" or "what other hooks would help?").
+
+**Want help implementing any of these?** Just ask and I can help you set up any of the recommendations above.
+```
+
+## Decision Framework
+
+### When to Recommend MCP Servers
+- External service integration needed (databases, APIs)
+- Documentation lookup for libraries/SDKs
+- Browser automation or testing
+- Team tool integration (GitHub, Linear, Slack)
+- Cloud infrastructure management
+
+### When to Recommend Skills
+- Complex multi-step workflows
+- Document generation needs
+- Specialized domain knowledge needed
+- Repeatable processes with templates
+
+### When to Recommend Hooks
+- Repetitive post-edit actions (formatting, linting)
+- Protection rules (block sensitive file edits)
+- Validation checks (tests, type checks)
+
+### When to Recommend Subagents
+- Specialized expertise needed (security, performance)
+- Parallel review workflows
+- Background quality checks
+
+### When to Recommend Slash Commands
+- Frequently repeated prompts
+- Commands with arguments
+- Quick project-specific workflows
+
+### When to Recommend Plugins
+- Need multiple related skills
+- Want pre-packaged automation bundles
+- Team-wide standardization
+
+---
+
+## Configuration Tips
+
+### MCP Server Setup
+
+**Team sharing**: Check `.mcp.json` into repo so entire team gets same MCP servers
+
+**Debugging**: Use `--mcp-debug` flag to identify configuration issues
+
+**Prerequisites to recommend:**
+- GitHub CLI (`gh`) - enables native GitHub operations
+- Puppeteer/Playwright CLI - for browser MCP servers
+
+### Headless Mode (for CI/Automation)
+
+Recommend headless Claude for automated pipelines:
+
+```bash
+# Pre-commit hook example
+claude -p "fix lint errors in src/" --allowedTools Edit,Write
+
+# CI pipeline with structured output
+claude -p "<prompt>" --output-format stream-json | your_command
+```
+
+### Permissions for Hooks
+
+Configure allowed tools in `.claude/settings.json`:
+
+```json
+{
+  "permissions": {
+    "allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
+  }
+}
+```
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/hooks-patterns.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/hooks-patterns.md
@@ -0,0 +1,147 @@
+# Hooks Recommendations
+
+Hooks automatically run commands in response to Claude's tool usage. They're ideal for enforcement and automation that should happen consistently.
+
+## Auto-Formatting Hooks
+
+### Prettier (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.prettierrc`, `.prettierrc.json`, `prettier.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-format
+**Value**: Code stays formatted without thinking about it
+
+### ESLint (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.eslintrc`, `.eslintrc.json`, `eslint.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-fix
+**Value**: Lint errors fixed automatically
+
+### Black/isort (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `pyproject.toml` with black/isort, `.black`, `setup.cfg` | ✓ |
+
+**Recommend**: PostToolUse hook to format Python files
+**Value**: Consistent Python formatting
+
+### Ruff (Python - Modern)
+| Detection | File Exists |
+|-----------|-------------|
+| `ruff.toml`, `pyproject.toml` with `[tool.ruff]` | ✓ |
+
+**Recommend**: PostToolUse hook for lint + format
+**Value**: Fast, comprehensive Python linting
+
+### gofmt (Go)
+| Detection | File Exists |
+|-----------|-------------|
+| `go.mod` | ✓ |
+
+**Recommend**: PostToolUse hook to run gofmt
+**Value**: Standard Go formatting
+
+### rustfmt (Rust)
+| Detection | File Exists |
+|-----------|-------------|
+| `Cargo.toml` | ✓ |
+
+**Recommend**: PostToolUse hook to run rustfmt
+**Value**: Standard Rust formatting
+
+---
+
+## Type Checking Hooks
+
+### TypeScript
+| Detection | File Exists |
+|-----------|-------------|
+| `tsconfig.json` | ✓ |
+
+**Recommend**: PostToolUse hook to run tsc --noEmit
+**Value**: Catch type errors immediately
+
+### mypy/pyright (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `mypy.ini`, `pyrightconfig.json`, pyproject.toml with mypy | ✓ |
+
+**Recommend**: PostToolUse hook for type checking
+**Value**: Catch type errors in Python
+
+---
+
+## Protection Hooks
+
+### Block Sensitive File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `.env`, `.env.local`, `.env.production` | Environment files |
+| `credentials.json`, `secrets.yaml` | Secret files |
+| `.git/` directory | Git internals |
+
+**Recommend**: PreToolUse hook that blocks Edit/Write to these paths
+**Value**: Prevent accidental secret exposure or git corruption
+
+### Block Lock File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml` | JS lock files |
+| `Cargo.lock`, `poetry.lock`, `Pipfile.lock` | Other lock files |
+
+**Recommend**: PreToolUse hook that blocks direct edits
+**Value**: Lock files should only change via package manager
+
+---
+
+## Test Runner Hooks
+
+### Jest (JavaScript/TypeScript)
+| Detection | Presence Of |
+|-----------|-------------|
+| `jest.config.js`, `jest` in package.json | Jest configured |
+| `__tests__/`, `*.test.ts`, `*.spec.ts` | Test files exist |
+
+**Recommend**: PostToolUse hook to run related tests after edit
+**Value**: Immediate test feedback on changes
+
+### pytest (Python)
+| Detection | Presence Of |
+|-----------|-------------|
+| `pytest.ini`, `pyproject.toml` with pytest | pytest configured |
+| `tests/`, `test_*.py` | Test files exist |
+
+**Recommend**: PostToolUse hook to run pytest on changed files
+**Value**: Immediate test feedback
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend This Hook |
+|------------|-------------------|
+| Prettier config | Auto-format on Edit/Write |
+| ESLint config | Auto-lint on Edit/Write |
+| Ruff/Black config | Auto-format Python |
+| tsconfig.json | Type-check on Edit |
+| Test directory | Run related tests on Edit |
+| .env files | Block .env edits |
+| Lock files | Block lock file edits |
+| Go project | gofmt on Edit |
+| Rust project | rustfmt on Edit |
+
+---
+
+## Hook Placement
+
+Hooks go in `.claude/settings.json`:
+
+```
+.claude/
+└── settings.json  ← Hook configurations here
+```
+
+Recommend creating the `.claude/` directory if it doesn't exist.
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/mcp-servers.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/mcp-servers.md
@@ -0,0 +1,261 @@
+# MCP Server Recommendations
+
+MCP (Model Context Protocol) servers extend Claude's capabilities by connecting to external tools and services.
+
+## Setup & Team Sharing
+
+**Connection methods:**
+1. **Project config** (`.mcp.json`) - Available only in that directory
+2. **Global config** (`~/.claude.json`) - Available across all projects
+3. **Checked-in `.mcp.json`** - Available to entire team (recommended!)
+
+**Tip**: Check `.mcp.json` into git so your whole team gets the same MCP servers.
+
+**Debugging**: Use `claude --mcp-debug` to identify configuration issues.
+
+## Documentation & Knowledge
+
+### context7
+**Best for**: Projects using popular libraries/SDKs where you want Claude to code with up-to-date documentation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Using React, Vue, Angular | Frontend frameworks |
+| Using Express, FastAPI, Django | Backend frameworks |
+| Using Prisma, Drizzle | ORMs |
+| Using Stripe, Twilio, SendGrid | Third-party APIs |
+| Using AWS SDK, Google Cloud | Cloud SDKs |
+| Using LangChain, OpenAI SDK | AI/ML libraries |
+
+**Value**: Claude fetches live documentation instead of relying on training data, reducing hallucinated APIs and outdated patterns.
+
+---
+
+## Browser & Frontend
+
+### Playwright MCP
+**Best for**: Frontend projects needing browser automation, testing, or screenshots
+
+| Recommend When | Examples |
+|----------------|----------|
+| React/Vue/Angular app | UI component testing |
+| E2E tests needed | User flow validation |
+| Visual regression testing | Screenshot comparisons |
+| Debugging UI issues | See what user sees |
+| Form testing | Multi-step workflows |
+
+**Value**: Claude can interact with your running app, take screenshots, fill forms, and verify UI behavior.
+
+### Puppeteer MCP
+**Best for**: Headless browser automation, web scraping
+
+| Recommend When | Examples |
+|----------------|----------|
+| PDF generation from HTML | Report generation |
+| Web scraping tasks | Data extraction |
+| Headless testing | CI environments |
+
+---
+
+## Databases
+
+### Supabase MCP
+**Best for**: Projects using Supabase for backend/database
+
+| Recommend When | Examples |
+|----------------|----------|
+| Supabase project detected | `@supabase/supabase-js` in deps |
+| Auth + database needs | User management apps |
+| Real-time features | Live data sync |
+
+**Value**: Claude can query tables, manage auth, and interact with Supabase storage directly.
+
+### PostgreSQL MCP
+**Best for**: Direct PostgreSQL database access
+
+| Recommend When | Examples |
+|----------------|----------|
+| Raw PostgreSQL usage | No ORM layer |
+| Database migrations | Schema management |
+| Data analysis tasks | Complex queries |
+| Debugging data issues | Inspect actual data |
+
+### Neon MCP
+**Best for**: Neon serverless Postgres users
+
+### Turso MCP
+**Best for**: Turso/libSQL edge database users
+
+---
+
+## Version Control & DevOps
+
+### GitHub MCP
+**Best for**: GitHub-hosted repositories needing issue/PR integration
+
+| Recommend When | Examples |
+|----------------|----------|
+| GitHub repository | `.git` with GitHub remote |
+| Issue-driven development | Reference issues in commits |
+| PR workflows | Review, merge operations |
+| GitHub Actions | CI/CD pipeline access |
+| Release management | Tag and release automation |
+
+**Value**: Claude can create issues, review PRs, check workflow runs, and manage releases.
+
+### GitLab MCP
+**Best for**: GitLab-hosted repositories
+
+### Linear MCP
+**Best for**: Teams using Linear for issue tracking
+
+| Recommend When | Examples |
+|----------------|----------|
+| Linear workspace | Issue references like `ABC-123` |
+| Sprint planning | Backlog management |
+| Issue creation from code | Auto-create issues for TODOs |
+
+---
+
+## Cloud Infrastructure
+
+### AWS MCP
+**Best for**: AWS infrastructure management
+
+| Recommend When | Examples |
+|----------------|----------|
+| AWS SDK in dependencies | `@aws-sdk/*` packages |
+| Infrastructure as code | Terraform, CDK, SAM |
+| Lambda development | Serverless functions |
+| S3, DynamoDB usage | Cloud data services |
+
+### Cloudflare MCP
+**Best for**: Cloudflare Workers, Pages, R2, D1
+
+| Recommend When | Examples |
+|----------------|----------|
+| Cloudflare Workers | Edge functions |
+| Pages deployment | Static site hosting |
+| R2 storage | Object storage |
+| D1 database | Edge SQL database |
+
+### Vercel MCP
+**Best for**: Vercel deployment and configuration
+
+---
+
+## Monitoring & Observtic
+
+### Sentry MCP
+**Best for**: Error tracking and debugging
+
+| Recommend When | Examples |
+|----------------|----------|
+| Sentry configured | `@sentry/*` in deps |
+| Production debugging | Investigate errors |
+| Error patterns | Group similar issues |
+| Release tracking | Correlate deploys with errors |
+
+**Value**: Claude can investigate Sentry issues, find root causes, and suggest fixes.
+
+### Datadog MCP
+**Best for**: APM, logs, and metrics
+
+---
+
+## Communication
+
+### Slack MCP
+**Best for**: Slack workspace integration
+
+| Recommend When | Examples |
+|----------------|----------|
+| Team uses Slack | Send notifications |
+| Deployment notifications | Alert channels |
+| Incident response | Post updates |
+
+### Notion MCP
+**Best for**: Notion workspace for documentation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Notion for docs | Read/update pages |
+| Knowledge base | Search documentation |
+| Meeting notes | Create summaries |
+
+---
+
+## File & Data
+
+### Filesystem MCP
+**Best for**: Enhanced file operations beyond built-in tools
+
+| Recommend When | Examples |
+|----------------|----------|
+| Complex file operations | Batch processing |
+| File watching | Monitor changes |
+| Advanced search | Custom patterns |
+
+### Memory MCP
+**Best for**: Persistent memory across sessions
+
+| Recommend When | Examples |
+|----------------|----------|
+| Long-running projects | Remember context |
+| User preferences | Store settings |
+| Learning patterns | Build knowledge |
+
+**Value**: Claude remembers project context, decisions, and patterns across conversations.
+
+---
+
+## Containers & DevOps
+
+### Docker MCP
+**Best for**: Container management
+
+| Recommend When | Examples |
+|----------------|----------|
+| Docker Compose file | Container orchestration |
+| Dockerfile present | Build images |
+| Container debugging | Inspect logs, exec |
+
+### Kubernetes MCP
+**Best for**: Kubernetes cluster management
+
+| Recommend When | Examples |
+|----------------|----------|
+| K8s manifests | Deploy, scale pods |
+| Helm charts | Package management |
+| Cluster debugging | Pod logs, status |
+
+---
+
+## AI & ML
+
+### Exa MCP
+**Best for**: Web search and research
+
+| Recommend When | Examples |
+|----------------|----------|
+| Research tasks | Find current info |
+| Competitive analysis | Market research |
+| Documentation gaps | Find examples |
+
+---
+
+## Quick Reference: Detection Patterns
+
+| Look For | Suggests MCP Server |
+|----------|-------------------|
+| Popular npm packages | context7 |
+| React/Vue/Next.js | Playwright MCP |
+| `@supabase/supabase-js` | Supabase MCP |
+| `pg` or `postgres` | PostgreSQL MCP |
+| GitHub remote | GitHub MCP |
+| `.linear` or Linear refs | Linear MCP |
+| `@aws-sdk/*` | AWS MCP |
+| `@sentry/*` | Sentry MCP |
+| `docker-compose.yml` | Docker MCP |
+| Slack webhook URLs | Slack MCP |
+| `@anthropic-ai/sdk` | context7 for Anthropic docs |
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/plugins-reference.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/plugins-reference.md
@@ -0,0 +1,89 @@
+# Plugin Recommendations
+
+Plugins are installable collections of skills that extend Claude's capabilities. They bundle related skills, reference materials, and workflows together.
+
+## Available Plugins
+
+### anthropic-agent-skills
+**The comprehensive skills bundle from Anthropic**
+
+| Recommend When | Examples |
+|----------------|----------|
+| General productivity | Default recommendation |
+| Document workflows | docx, xlsx, pptx, pdf |
+| Frontend development | frontend-design, webapp-testing |
+| Building AI tools | mcp-builder, skill-creator |
+| Creative work | canvas-design, algorithmic-art |
+
+**Includes**: docx, xlsx, pptx, pdf, frontend-design, canvas-design, algorithmic-art, mcp-builder, skill-creator, webapp-testing, doc-coauthoring, internal-comms, brand-guidelines, theme-factory, slack-gif-creator, web-artifacts-builder
+
+**Install**: This plugin is commonly pre-installed. Check with `claude plugins list`.
+
+---
+
+### frontend-design
+**Specialized frontend UI development**
+
+| Recommend When | Examples |
+|----------------|----------|
+| React/Vue/Angular work | Component development |
+| Landing pages | Marketing sites |
+| Dashboard UI | Admin interfaces |
+| Design system | Component libraries |
+
+**Value**: Creates distinctive, production-grade UI avoiding generic AI aesthetics.
+
+---
+
+## Plugin vs Individual Skills
+
+### When to Recommend Plugin Installation
+- User needs multiple related skills
+- Team standardization desired
+- First-time Claude Code setup
+- Comprehensive capability needed
+
+### When to Recommend Individual Skill Usage
+- Specific one-time task
+- Already have plugin installed
+- Just need one capability
+
+---
+
+## Checking Installed Plugins
+
+```bash
+# List installed plugins
+claude plugins list
+
+# Check available skills
+claude skills list
+```
+
+---
+
+## Custom Plugin Development
+
+For teams wanting to bundle their own skills:
+
+| Recommend When | Examples |
+|----------------|----------|
+| Company-specific workflows | Internal processes |
+| Team best practices | Shared patterns |
+| Domain expertise | Industry knowledge |
+| Tool integrations | Internal tools |
+
+Use the **skill-creator** skill to build individual skills, then bundle them into a plugin for team distribution.
+
+---
+
+## Quick Reference
+
+| Need | Recommended Plugin/Skill |
+|------|-------------------------|
+| General productivity | anthropic-agent-skills (full bundle) |
+| Document creation | docx, xlsx, pptx, pdf skills |
+| Frontend work | frontend-design plugin |
+| Testing | webapp-testing skill |
+| Building tools | mcp-builder skill |
+| Custom workflows | skill-creator skill |
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/skills-reference.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/skills-reference.md
@@ -0,0 +1,216 @@
+# Skills Recommendations
+
+Skills are packaged expertise with workflows, reference materials, and best practices that Claude can invoke for specialized tasks.
+
+## Built-in Agents
+
+### Plan Agent
+**Best for**: Complex implementations needing architectural planning
+
+| Recommend When | Examples |
+|----------------|----------|
+| Multi-file changes needed | New feature development |
+| Architectural decisions | System design |
+| Unknown scope | Needs investigation first |
+| Multiple valid approaches | Trade-off analysis |
+
+**Value**: Thinks through implementation before coding, identifies files to change, considers edge cases.
+
+### Explore Agent
+**Best for**: Understanding large or unfamiliar codebases
+
+| Recommend When | Examples |
+|----------------|----------|
+| Large codebase (>500 files) | Navigate efficiently |
+| New to the project | Understand structure |
+| Finding patterns | How is X done? |
+| Debugging | Trace execution paths |
+
+**Value**: Quickly searches, reads, and synthesizes information across many files.
+
+---
+
+## Document Creation Skills
+
+### docx (Word Documents)
+**Best for**: Creating and editing Word documents
+
+| Recommend When | Examples |
+|----------------|----------|
+| Report generation | Technical reports |
+| Contract templates | Legal documents |
+| Documentation export | Share with non-developers |
+| Tracked changes | Review workflows |
+
+### xlsx (Spreadsheets)
+**Best for**: Creating and analyzing Excel files
+
+| Recommend When | Examples |
+|----------------|----------|
+| Data analysis | Process CSV/Excel data |
+| Report generation | Formatted tables |
+| Financial models | Formulas and calculations |
+| Data transformation | Clean and reshape data |
+
+### pptx (Presentations)
+**Best for**: Creating PowerPoint presentations
+
+| Recommend When | Examples |
+|----------------|----------|
+| Technical presentations | Architecture diagrams |
+| Project updates | Status slides |
+| Demo decks | Feature walkthroughs |
+| Training materials | Educational content |
+
+### pdf (PDF Documents)
+**Best for**: PDF manipulation and creation
+
+| Recommend When | Examples |
+|----------------|----------|
+| Form filling | Complete PDF forms |
+| Document merging | Combine files |
+| Text extraction | Parse PDF content |
+| PDF generation | Create from data |
+
+---
+
+## Frontend & Design Skills
+
+### frontend-design
+**Best for**: Creating polished, production-ready UI components
+
+| Recommend When | Examples |
+|----------------|----------|
+| UI component work | React, Vue, Angular |
+| Landing pages | Marketing sites |
+| Dashboard design | Data visualization |
+| Design system work | Component libraries |
+
+**Value**: Creates distinctive, high-quality UI instead of generic AI aesthetics.
+
+### canvas-design
+**Best for**: Creating visual art and static designs
+
+| Recommend When | Examples |
+|----------------|----------|
+| Poster creation | Marketing materials |
+| Visual diagrams | Architecture visuals |
+| Infographics | Data visualization |
+
+### algorithmic-art
+**Best for**: Generative art with p5.js
+
+| Recommend When | Examples |
+|----------------|----------|
+| Interactive visuals | Creative coding |
+| Generative patterns | Flow fields, particles |
+| Data art | Algorithmic visualization |
+
+### theme-factory
+**Best for**: Applying themes to artifacts
+
+| Recommend When | Examples |
+|----------------|----------|
+| Brand consistency | Apply company colors |
+| Document styling | Professional look |
+| Presentation themes | Consistent decks |
+
+### brand-guidelines
+**Best for**: Applying Anthropic brand styling
+
+| Recommend When | Examples |
+|----------------|----------|
+| Anthropic materials | Official branding |
+| Partner materials | Co-branded content |
+
+---
+
+## Development Skills
+
+### mcp-builder
+**Best for**: Creating MCP servers to extend Claude
+
+| Recommend When | Examples |
+|----------------|----------|
+| Custom tool needs | Internal APIs |
+| API integrations | Third-party services |
+| Workflow automation | Custom tooling |
+
+**Value**: Guides creation of well-designed MCP servers in Python (FastMCP) or TypeScript.
+
+### webapp-testing
+**Best for**: Testing web applications with Playwright
+
+| Recommend When | Examples |
+|----------------|----------|
+| UI testing needs | Verify functionality |
+| Visual debugging | Screenshot issues |
+| Browser automation | Interactive testing |
+| Console log analysis | Debug JS errors |
+
+### skill-creator
+**Best for**: Creating new skills for Claude
+
+| Recommend When | Examples |
+|----------------|----------|
+| Repeatable workflows | Standardize processes |
+| Domain expertise | Package knowledge |
+| Team patterns | Share best practices |
+
+---
+
+## Collaboration Skills
+
+### doc-coauthoring
+**Best for**: Co-authoring documentation with users
+
+| Recommend When | Examples |
+|----------------|----------|
+| Technical specs | RFC documents |
+| Decision docs | ADRs |
+| Proposals | Feature proposals |
+| Documentation | User guides |
+
+**Value**: Structured workflow for iterative document refinement.
+
+### internal-comms
+**Best for**: Writing internal communications
+
+| Recommend When | Examples |
+|----------------|----------|
+| Status reports | Project updates |
+| Announcements | Team comms |
+| Incident reports | Post-mortems |
+| FAQs | Knowledge sharing |
+
+---
+
+## Multimedia Skills
+
+### slack-gif-creator
+**Best for**: Creating animated GIFs for Slack
+
+| Recommend When | Examples |
+|----------------|----------|
+| Team celebrations | Achievements |
+| Demo animations | Feature previews |
+| Fun reactions | Custom emoji-style GIFs |
+
+---
+
+## Quick Reference: Detection Patterns
+
+| Look For | Suggests Skill |
+|----------|---------------|
+| Complex task, multiple files | Plan agent |
+| "How does X work?" | Explore agent |
+| `.docx` files or doc requests | docx skill |
+| `.xlsx` files or spreadsheet work | xlsx skill |
+| Presentation needs | pptx skill |
+| PDF files to process | pdf skill |
+| React/Vue/Angular components | frontend-design |
+| UI design requests | canvas-design |
+| Testing local web app | webapp-testing |
+| "Build an MCP server" | mcp-builder |
+| Documentation writing | doc-coauthoring |
+| Internal announcement | internal-comms |
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/slash-command-examples.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/slash-command-examples.md
@@ -0,0 +1,251 @@
+# Slash Command Recommendations
+
+Slash commands are quick, repeatable prompts with optional arguments. They're ideal for frequently used workflows that don't need the overhead of a subagent.
+
+## Code Review Commands
+
+### /pr-review
+**Best for**: Reviewing current branch changes
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Git-based workflow | `.git/` directory |
+| PR-driven development | GitHub/GitLab remote |
+| Regular code reviews | Team process |
+
+**Value**: Quick review of PR changes with actionable feedback
+
+---
+
+### /quick-review
+**Best for**: Fast review of a specific file
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Single file review needs | Ad-hoc reviews |
+| Pre-commit checks | Before committing |
+
+**Value**: Focused review without full PR context
+
+---
+
+## Testing Commands
+
+### /test
+**Best for**: Running tests for a specific file or pattern
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Jest configured | `jest.config.js`, package.json |
+| pytest configured | `pytest.ini`, pyproject.toml |
+| vitest configured | `vitest.config.js` |
+| Test directory exists | `tests/`, `__tests__/` |
+
+**Value**: Quick test runs with failure analysis
+
+---
+
+### /test-file
+**Best for**: Generating tests for a specific file
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Test framework present | Testing deps installed |
+| Source files without tests | Missing test coverage |
+
+**Value**: Generates tests following project conventions
+
+---
+
+## Documentation Commands
+
+### /doc
+**Best for**: Generating documentation for code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| JSDoc/docstring patterns | Existing doc style |
+| API code | Public functions/classes |
+
+**Value**: Consistent documentation format
+
+---
+
+### /api-doc
+**Best for**: Documenting API endpoints
+
+| Recommend When | Detection |
+|----------------|-----------|
+| REST endpoints | Express, FastAPI routes |
+| OpenAPI/Swagger | Existing spec files |
+| Undocumented APIs | Routes without docs |
+
+**Value**: Generates endpoint docs with examples
+
+---
+
+### /changelog
+**Best for**: Updating changelog with recent changes
+
+| Recommend When | Detection |
+|----------------|-----------|
+| CHANGELOG.md exists | Changelog present |
+| Release workflow | Semantic versioning |
+
+**Value**: Categorized changelog entries
+
+---
+
+## Debugging Commands
+
+### /debug
+**Best for**: Investigating issues in code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Bug reports common | Active development |
+| Complex codebase | Many files/dependencies |
+
+**Value**: Systematic debugging approach
+
+---
+
+### /ci-fix
+**Best for**: Debugging CI/CD failures
+
+| Recommend When | Detection |
+|----------------|-----------|
+| CI configured | `.github/workflows/`, `.circleci/` |
+| Frequent CI failures | Active CI pipeline |
+
+**Value**: Reproduces and fixes CI issues
+
+---
+
+## Refactoring Commands
+
+### /refactor
+**Best for**: Improving code structure
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Legacy code | Old patterns detected |
+| Code smells | Long files, complex functions |
+
+**Value**: Guided refactoring with explanations
+
+---
+
+### /extract
+**Best for**: Extracting reusable code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Code duplication | Similar patterns |
+| Long functions | Needs decomposition |
+
+**Value**: Creates clean extractions with proper types
+
+---
+
+## Project Commands
+
+### /init-claude
+**Best for**: Setting up Claude Code configuration
+
+| Recommend When | Detection |
+|----------------|-----------|
+| No `.claude/` directory | New project setup |
+| No CLAUDE.md | Missing context |
+
+**Value**: Creates complete Claude Code setup
+
+---
+
+### /setup
+**Best for**: Developer environment setup
+
+| Recommend When | Detection |
+|----------------|-----------|
+| New developer onboarding | README instructions |
+| Complex setup | Multiple steps needed |
+
+**Value**: Automated environment setup
+
+---
+
+## Utility Commands
+
+### /explain
+**Best for**: Understanding code
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Complex codebase | New to project |
+| Legacy code | Undocumented patterns |
+
+**Value**: Clear explanations without jargon
+
+---
+
+### /find
+**Best for**: Locating code by description
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Large codebase | Many files |
+| Unfamiliar structure | New to project |
+
+**Value**: Finds code by concept, not just text
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend Command |
+|------------|------------------|
+| Git repository | /pr-review |
+| Test framework | /test |
+| Test gaps | /test-file |
+| API routes | /api-doc |
+| CHANGELOG.md | /changelog |
+| CI/CD config | /ci-fix |
+| Complex code | /explain |
+| Large codebase | /find |
+| No .claude/ | /init-claude |
+
+---
+
+## Slash Command Placement
+
+Commands go in `.claude/commands/`:
+
+```
+.claude/
+└── commands/
+    ├── test.md
+    ├── pr-review.md
+    └── explain.md
+```
+
+---
+
+## Argument Patterns
+
+| Pattern | Meaning | Example |
+|---------|---------|---------|
+| `<arg>` | Required | `<file-path>` |
+| `[arg]` | Optional | `[branch-name]` |
+| `$ARGUMENTS` | All args as string | Full input |
+| `$1`, `$2` | Positional args | First, second arg |
+
+---
+
+## Tool Restrictions Guide
+
+| Use Case | Restrict To |
+|----------|------------|
+| Read-only | Read, Grep, Glob |
+| Can edit | + Write |
+| Can run commands | + Bash |
+| Full access | Omit restriction |
--- a/plugins/claude-code-setup/skills/claude-automation-recommender/references/subagent-templates.md
+++ b/plugins/claude-code-setup/skills/claude-automation-recommender/references/subagent-templates.md
@@ -0,0 +1,179 @@
+# Subagent Recommendations
+
+Subagents are specialized Claude instances that run in parallel, each with their own context window and tool access. They're ideal for focused reviews, analysis, or generation tasks.
+
+## Code Review Agents
+
+### code-reviewer
+**Best for**: Automated code quality checks on large codebases
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Large codebase (>500 files) | File count |
+| Frequent code changes | Active development |
+| Team wants consistent review | Quality focus |
+
+**Value**: Runs code review in parallel while you continue working
+**Model**: sonnet (balanced quality/speed)
+**Tools**: Read, Grep, Glob, Bash
+
+---
+
+### security-reviewer
+**Best for**: Security-focused code review
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Auth code present | `auth/`, `login`, `session` patterns |
+| Payment processing | `stripe`, `payment`, `billing` patterns |
+| User data handling | `user`, `profile`, `pii` patterns |
+| API keys in code | Environment variable patterns |
+
+**Value**: Catches OWASP vulnerabilities, auth issues, data exposure
+**Model**: sonnet
+**Tools**: Read, Grep, Glob (read-only for safety)
+
+---
+
+### test-writer
+**Best for**: Generating comprehensive test coverage
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Low test coverage | Few test files vs source files |
+| Test suite exists | `tests/`, `__tests__/` present |
+| Testing framework configured | jest, pytest, vitest in deps |
+
+**Value**: Generates tests matching project conventions
+**Model**: sonnet
+**Tools**: Read, Write, Grep, Glob
+
+---
+
+## Specialized Agents
+
+### api-documenter
+**Best for**: API documentation generation
+
+| Recommend When | Detection |
+|----------------|-----------|
+| REST endpoints | Express routes, FastAPI paths |
+| GraphQL schema | `.graphql` files |
+| OpenAPI exists | `openapi.yaml`, `swagger.json` |
+| Undocumented APIs | Routes without docs |
+
+**Value**: Generates OpenAPI specs, endpoint documentation
+**Model**: sonnet
+**Tools**: Read, Write, Grep, Glob
+
+---
+
+### performance-analyzer
+**Best for**: Finding performance bottlenecks
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Database queries | ORM usage, raw SQL |
+| High-traffic code | API endpoints, hot paths |
+| Performance complaints | User reports slowness |
+| Complex algorithms | Nested loops, recursion |
+
+**Value**: Finds N+1 queries, O(n²) algorithms, memory leaks
+**Model**: sonnet
+**Tools**: Read, Grep, Glob, Bash
+
+---
+
+### ui-reviewer
+**Best for**: Frontend accessibility and UX review
+
+| Recommend When | Detection |
+|----------------|-----------|
+| React/Vue/Angular | Frontend framework detected |
+| Component library | `components/` directory |
+| User-facing UI | Not just API project |
+
+**Value**: Catches accessibility issues, UX problems, responsive design gaps
+**Model**: sonnet
+**Tools**: Read, Grep, Glob
+
+---
+
+## Utility Agents
+
+### dependency-updater
+**Best for**: Safe dependency updates
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Outdated deps | `npm outdated` has results |
+| Security advisories | `npm audit` warnings |
+| Major version behind | Significant version gaps |
+
+**Value**: Updates dependencies incrementally with testing
+**Model**: sonnet
+**Tools**: Read, Write, Bash, Grep
+
+---
+
+### migration-helper
+**Best for**: Framework/version migrations
+
+| Recommend When | Detection |
+|----------------|-----------|
+| Major upgrade needed | Framework version very old |
+| Breaking changes coming | Deprecation warnings |
+| Refactoring planned | Architectural changes |
+
+**Value**: Plans and executes migrations incrementally
+**Model**: opus (complex reasoning needed)
+**Tools**: Read, Write, Grep, Glob, Bash
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend Subagent |
+|------------|-------------------|
+| Large codebase | code-reviewer |
+| Auth/payment code | security-reviewer |
+| Few tests | test-writer |
+| API routes | api-documenter |
+| Database heavy | performance-analyzer |
+| Frontend components | ui-reviewer |
+| Outdated packages | dependency-updater |
+| Old framework version | migration-helper |
+
+---
+
+## Subagent Placement
+
+Subagents go in `.claude/agents/`:
+
+```
+.claude/
+└── agents/
+    ├── code-reviewer.md
+    ├── security-reviewer.md
+    └── test-writer.md
+```
+
+---
+
+## Model Selection Guide
+
+| Model | Best For | Trade-off |
+|-------|----------|-----------|
+| **haiku** | Simple, repetitive checks | Fast, cheap, less thorough |
+| **sonnet** | Most review/analysis tasks | Balanced (recommended default) |
+| **opus** | Complex migrations, architecture | Thorough, slower, more expensive |
+
+---
+
+## Tool Access Guide
+
+| Access Level | Tools | Use Case |
+|--------------|-------|----------|
+| Read-only | Read, Grep, Glob | Reviews, analysis |
+| Writing | + Write | Code generation, docs |
+| Full | + Bash | Migrations, testing |