Skip to content
claude-automation-recommender logo

Claude Automation Recommender

claude-automation-recommender

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 f...

SKILL.md

Full skill instructions

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

TypeBest For
HooksAutomatic actions on tool events (format on save, lint, block edits)
SubagentsSpecialized reviewers/​analyzers that run in parallel
SkillsPackaged expertise with workflows and reference material
Slash CommandsQuick, repeatable prompts with arguments
PluginsCollections of skills that can be installed
MCP ServersExternal tool integrations (databases, APIs, browsers, docs)

Workflow

Phase 1: Codebase Analysis

Gather project context:

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

CategoryWhat to Look ForInforms Recommendations For
Language/​Frameworkpackage.json, pyproject.toml, import patternsHooks, MCP servers
Frontend stackReact, Vue, Angular, Next.jsPlaywright MCP, frontend skills
Backend stackExpress, FastAPI, DjangoAPI documentation tools
DatabasePrisma, Supabase, raw SQLDatabase MCP servers
External APIsStripe, OpenAI, AWS SDKscontext7 MCP for docs
TestingJest, pytest, Playwright configsTesting hooks, subagents
CI/​CDGitHub Actions, CircleCIGitHub MCP server
Issue trackingLinear, Jira referencesIssue tracker MCP
Docs patternsOpenAPI, JSDoc, docstringsDocumentation skills

Phase 2: Generate Recommendations

Based on analysis, generate recommendations across all categories:

A. MCP Server Recommendations

See references/​mcp-servers.md for detailed patterns.

Codebase SignalRecommended MCP Server
Uses popular libraries (React, Express, etc.)context7 - Live documentation lookup
Frontend with UI testing needsPlaywright - Browser automation/​testing
Uses SupabaseSupabase MCP - Direct database operations
PostgreSQL/​MySQL databaseDatabase MCP - Query and schema tools
GitHub repositoryGitHub MCP - Issues, PRs, actions
Uses Linear for issuesLinear MCP - Issue management
AWS infrastructureAWS MCP - Cloud resource management
Slack workspaceSlack MCP - Team notifications
Memory/​context persistenceMemory MCP - Cross-session memory
Sentry error trackingSentry MCP - Error investigation
Docker containersDocker MCP - Container management
B. Skills Recommendations

See references/​skills-reference.md for patterns.

Codebase SignalRecommended Skill
Complex implementation tasksPlan agent - Architecture planning
Large codebaseExplore agent - Codebase navigation
Creates documentsdocx skill - Word document generation
Creates spreadsheetsxlsx skill - Excel creation
Creates presentationspptx skill - PowerPoint generation
PDF workflowspdf skill - PDF manipulation
Frontend UI workfrontend-design - UI component design
Needs custom Claude toolsmcp-builder - Build MCP servers
Wants branded outputbrand-guidelines - Apply brand styling
Testing web appswebapp-testing - Playwright testing
C. Hooks Recommendations

See references/​hooks-patterns.md for configurations.

Codebase SignalRecommended Hook
Prettier configuredPostToolUse: auto-format on edit
ESLint/​Ruff configuredPostToolUse: auto-lint on edit
TypeScript projectPostToolUse: type-check on edit
Tests directory existsPostToolUse: run related tests
.env files presentPreToolUse: block .env edits
Lock files presentPreToolUse: block lock file edits
Security-sensitive codePreToolUse: require confirmation
D. Subagent Recommendations

See references/​subagent-templates.md for templates.

Codebase SignalRecommended Subagent
Large codebase (>500 files)code-reviewer - Parallel code review
Auth/​payments codesecurity-reviewer - Security audits
API projectapi-documenter - OpenAPI generation
Performance criticalperformance-analyzer - Bottleneck detection
Frontend heavyui-reviewer - Accessibility review
Needs more teststest-writer - Test generation
E. Slash Command Recommendations

See references/​slash-command-examples.md for templates.

Codebase SignalRecommended 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 for available plugins.

Codebase SignalRecommended Plugin
General productivityanthropic-agent-skills - Core skills bundle
Document workflowsInstall docx, xlsx, pdf skills
Frontend developmentfrontend-design plugin
Building AI toolsmcp-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.

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

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

{
  "permissions": {
    "allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
  }
}

More skills from diegosouzapw

accessibility logo
diegosouzapw/awesome-omni-skill

accessibility

Accessibility guidelines for VS Code features — covers accessibility help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts/status announcements, keyboard navigation, and ARIA labels/roles. Applies to both new interactive UI surfaces and updates to existing feature...

62 1
View
mermaid-diagrams logo
diegosouzapw/awesome-omni-skill

mermaid-diagrams

Mermaid diagram creation for flowcharts, sequences, ERDs, and more. Generate diagrams from text in markdown files. Use for documentation, architecture diagrams, and visual representations. Triggers on mermaid, flowchart, sequence diagram, ERD, entity relationship, gantt chart, pie chart, class di...

62 1
View
tauri2-react-rust logo
diegosouzapw/awesome-omni-skill

tauri2-react-rust

Guides development of cross-platform desktop apps with Tauri 2, TypeScript, React, and Rust. Use when building Tauri apps, implementing IPC, designing Rust backend or TypeScript/React frontend, when researching or cloning a website (open site, snapshot elements), when verifying local dev or built...

62 1
View
fp-ts-errors logo
diegosouzapw/awesome-omni-skill

fp-ts-errors

Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.

62 0
View
ring:pre-dev-research logo
diegosouzapw/awesome-omni-skill

ring:pre-dev-research

Gate 0 research phase for pre-dev workflow. Dispatches 3 parallel research agents to gather codebase patterns, external best practices, and framework documentation BEFORE creating PRD/TRD. Outputs research.md with file:line references.

62 0
View
create-assistant logo
diegosouzapw/awesome-omni-skill

create-assistant

Create and configure Vapi voice AI assistants with models, voices, transcribers, tools, hooks, and advanced settings. Use when building voice agents, phone bots, customer support assistants, or any conversational AI that handles phone or web calls.

62 0
View
codex-headless logo
diegosouzapw/awesome-omni-skill

codex-headless

Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.

62 0
View
social-media-scheduler logo
diegosouzapw/awesome-omni-skill

social-media-scheduler

Generate a full week of social media content for any topic. Outputs platform-optimized posts for Twitter/X, LinkedIn, and Instagram with hashtags and posting times.

62 0
View
Data Privacy Compliance logo
diegosouzapw/awesome-omni-skill

Data Privacy Compliance

Data privacy and regulatory compliance specialist for GDPR, CCPA, HIPAA, and international data protection laws. Use when implementing privacy controls, conducting data protection impact assessments, ensuring regulatory compliance, or managing data subject rights. Expert in consent management, da...

62 0
View
triple-review logo
diegosouzapw/awesome-omni-skill

triple-review

Reviews a task using the TRIPLE protocol, as the review agent.

62 0
View
Tech Stack & Architecture Decision logo
diegosouzapw/awesome-omni-skill

Tech Stack & Architecture Decision

Define and document the technology stack and architecture decisions for a project. Use when the user needs to choose a tech stack, make architecture decisions, define infrastructure choices, or document technology selections. Triggers on requests like "define the tech stack", "choose technologies...

62 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View