Official agent skill

Claude Automation Recommender

by anthropics in anthropics/claude-plugins-official

Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files.

OfficialApache-2.0Auto-check: notesAgent Workflows

Install Claude Automation Recommender

skills CLI
$ npx skills add anthropics/claude-plugins-official --skill claude-automation-recommender -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install anthropics/claude-plugins-official claude-automation-recommender --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/anthropics/claude-plugins-official.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/claude-code-setup/skills/claude-automation-recommender .claude/skills/claude-automation-recommender && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
claude-automation-recommender
GitHub stars
38k
Used in
3 other repos
Token cost
~2.7k tokens
SKILL.md length
743 words
Files
6 (incl. references)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files.

  • Works in 3 steps: Codebase Analysis → Generate Recommendations → Output Recommendations Report
  • Setting up Claude Code for a project for the first time
  • SKILL.md covers Output Guidelines, Automation Types Overview and Workflow
  • Calls claude, fastapi and supabase

What it does

This skill is read-only: it studies your project and outputs recommendations, and you build them yourself or ask separately for help. Phase one gathers context by checking for files such as package.json, pyproject.toml, Cargo.toml, go.mod and pom.xml, then maps what it finds to suggestions. Frontend stack, backend stack, database, external APIs, testing setup, CI/CD, issue tracker and documentation patterns each point toward particular hooks, MCP servers, skills or subagents.

It keeps the output short, surfacing the top one or two automations per type, or three to five when you ask about one type. The reference files list common patterns for hooks, MCP servers, plugins, skills and subagent templates, and the agent is told to go beyond them with web search for tools and libraries specific to your codebase. It ends by saying you can ask for more in any category.

When your agent uses it

  • Setting up Claude Code for a project for the first time
  • Looking for hooks, subagents or MCP servers that suit your stack
  • Reviewing an existing Claude Code setup for gaps
  • Finding out which Claude Code features are worth using on a codebase

Example prompts

  • “Look at this repo and recommend Claude Code automations.”
  • “What hooks would help on this project? Give me more options than usual.”
  • “Which MCP servers should I add for this Next.js and Prisma app?”

Requirements

  • Web search access for stack-specific suggestions

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Codebase Analysis
  2. Generate Recommendations
  3. Output Recommendations Report

What it can do on your machine

Read from SKILL.md and the folder at commit f359d43. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • fastapi
    • supabase

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use supabase, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Automation Recommender loads about 2.7k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 743 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:125
    | `.env` files present | PreToolUse: block `.env` edits |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from anthropics/claude-plugins-official at commit f359d43, republished under its Apache-2.0 licence (© anthropics). 743 words, ~2,745 tokens.

Download SKILL.mdSave it as .claude/skills/claude-automation-recommender/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
claude-automation-recommender
description
Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, 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)
  • Go beyond the reference lists: The reference files contain common patterns, but use web search to find recommendations specific to the codebase's tools, frameworks, and libraries
  • 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, workflows, and repeatable tasks (invoked by Claude or user via /skill-name)
PluginsCollections of skills that can be installed
MCP ServersExternal 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|convex|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, Convex, raw SQLDatabase / backend 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
Uses ConvexConvex MCP - Live deployment introspection, run queries/mutations, manage env vars and logs
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
Show full SKILL.md (342 more words)Show less
B. Skills Recommendations

See references/skills-reference.md for details.

Create skills in .claude/skills/<name>/SKILL.md. Some are also available via plugins:

Codebase SignalSkillPlugin
Building pluginsskill-developmentplugin-dev
Git commitscommitcommit-commands
React/Vue/Angularfrontend-designfrontend-design
Automation ruleswriting-ruleshookify
Feature planningfeature-devfeature-dev

Custom skills to create (with templates, scripts, examples):

Codebase SignalSkill to CreateInvocation
API routesapi-doc (with OpenAPI template)Both
Database projectcreate-migration (with validation script)User-only
Test suitegen-test (with example tests)User-only
Component librarynew-component (with templates)User-only
PR workflowpr-check (with checklist)User-only
Releasesrelease-notes (with git context)User-only
Code styleproject-conventionsClaude-only
Onboardingsetup-dev (with prereq script)User-only
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. 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.

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]
**Create**: `.claude/skills/[name]/SKILL.md`
**Invocation**: User-only / Both / Claude-only
**Also available in**: [plugin-name] plugin (if applicable)
```yaml
---
name: [skill-name]
description: [what it does]
disable-model-invocation: true  # for user-only
---

⚡ 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


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

- Document generation (docx, xlsx, pptx, pdf — also in plugins)
- Frequently repeated prompts or workflows
- Project-specific tasks with arguments
- Applying templates or scripts to tasks (skills can bundle supporting files)
- Quick actions invoked with `/skill-name`
- Workflows that should run in isolation (`context: fork`)

**Invocation control:**
- `disable-model-invocation: true` — User-only (for side effects: deploy, commit, send)
- `user-invocable: false` — Claude-only (for background knowledge)
- Default (omit both) — Both can invoke

### 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 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:*)"]
  }
}

© anthropics, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in plugins/claude-code-setup/skills/claude-automation-recommender of anthropics/claude-plugins-official.

  • SKILL.md
  • references/hooks-patterns.md
  • references/mcp-servers.md
  • references/plugins-reference.md
  • references/skills-reference.md
  • references/subagent-templates.md

Open the folder on GitHubat commit f359d43

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in anthropics/claude-plugins-official, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Claude Automation Recommender next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Automation Recommender compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Automation Recommender this skillanthropics/claude-plugins-official38k3 repos~2.7kAutomated safety check: NotesApache-2.0
Claude Code Advanced Guide2025Emma/vibe-coding-cn23k1 repos~1.4kAutomated safety check: PassMIT
Claude Code Mastery Squadohmyjahh/xquads-squads277—~1.1kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
OpenpetsOpenPetsHQ/openpets1.3k—~2.1kAutomated safety check: PassMIT
CC Workflow Studio AI Editorbreaking-brake/cc-wf-studio5.4k—~561Automated safety check: PassCustom licence

Similar skills

  • Claude Code Advanced Guide

    2025Emma/vibe-coding-cn

    A Chinese-language tutorial on advanced Claude Code use: its core tools, REPL, slash commands, workflows, permissions, memory, MCP, hooks and sub-agents.

    23k GitHub starsUsed in 1 repo~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Mastery Squad

    ohmyjahh/xquads-squads

    Routes a request to one of eight specialist agents covering hooks, skills, subagents, MCP integration and context engineering for Claude Code.

    277 GitHub stars~1.1k tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Openpets

    OpenPetsHQ/openpets

    A skill your agent uses whenever the user wants to build, extend, debug, test, validate, locally load, package, or publish an OpenPets plugin; work with the OpenPets Plugin SDK v3, plugin manifest…

    1.3k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • CC Workflow Studio AI Editor

    breaking-brake/cc-wf-studio

    Creates and edits visual agent workflows in CC Workflow Studio through conversation, with the agent reading and writing the canvas over MCP.

    5.4k GitHub stars~561 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Mistral Vibe Plugin Creator

    mistralai/mistral-vibe

    Official

    Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.

    5.1k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from anthropics/claude-plugins-official

All 29 skills in this repo
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Auto-check: notes
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Auto-check passed
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Auto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Auto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Auto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Auto-check passed

Categories

Questions about Claude Automation Recommender

What does Claude Automation Recommender do?

Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files. This skill is read-only: it studies your project and outputs recommendations, and you build them yourself or ask separately for help.xml, then maps what it finds to suggestions.

When should I use Claude Automation Recommender?

Claude Automation Recommender fits situations like: setting up Claude Code for a project for the first time; looking for hooks, subagents or MCP servers that suit your stack; reviewing an existing Claude Code setup for gaps; finding out which Claude Code features are worth using on a codebase.

How do I install Claude Automation Recommender in Claude Code?

Run `npx skills add anthropics/claude-plugins-official --skill claude-automation-recommender -a claude-code`. Or copy the skill folder (plugins/claude-code-setup/skills/claude-automation-recommender in anthropics/claude-plugins-official) into .claude/skills/claude-automation-recommender in your project. Claude Code loads it when a task matches its description.

How do I install Claude Automation Recommender in Codex?

Run `npx skills add anthropics/claude-plugins-official --skill claude-automation-recommender -a codex`. Or copy the skill folder (plugins/claude-code-setup/skills/claude-automation-recommender in anthropics/claude-plugins-official) into .agents/skills/claude-automation-recommender in your project. Codex loads it when a task matches its description.

Can I use Claude Automation Recommender in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add anthropics/claude-plugins-official --skill claude-automation-recommender -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-automation-recommender, .gemini/skills/claude-automation-recommender, .github/skills/claude-automation-recommender and .opencode/skills/claude-automation-recommender in your project.

What does Claude Automation Recommender need to run?

Going by SKILL.md and its folder, Claude Automation Recommender needs the command-line tools its instructions call (claude, fastapi and supabase). Our summary lists: Web search access for stack-specific suggestions.

Does Claude Automation Recommender access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Claude Automation Recommender safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Claude Automation Recommender use?

Claude Automation Recommender is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude Automation Recommender use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.1k tokens, read only when the agent opens those files.

What are the alternatives to Claude Automation Recommender?

Skills that share tags, products or a category with Claude Automation Recommender: Claude Code Advanced Guide (2025Emma/vibe-coding-cn, 23k stars), Claude Code Mastery Squad (ohmyjahh/xquads-squads, 277 stars), Crush Configuration (charmbracelet/crush, 29k stars) and Openpets (OpenPetsHQ/openpets, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Automation Recommender?

anthropics (a GitHub organization, an official publisher) maintains it in anthropics/claude-plugins-official, which has 37,644 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 11, 2026.

Source: anthropics/claude-plugins-official on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.