Recomendador de Automatizaciones para Claude
Analiza patrones de código fuente para recomendar automatizaciones de Claude Code en todas las opciones de extensibilidad.
Este skill es de solo lectura. Analiza el código base y genera recomendaciones. NO crea ni modifica ningún archivo. Los usuarios implementan las recomendaciones por sí mismos o le piden a Claude que les ayude a crearlas por separado.
Guías de Salida
- Recomendar 1-2 de cada tipo: No abrumar: mostrar las 1-2 automatizaciones más valiosas por categoría.
- Si el usuario pide un tipo específico: Centrarse solo en ese tipo y ofrecer más opciones (3-5 recomendaciones).
- Ir más allá de las listas de referencia: Los archivos de referencia contienen patrones comunes, pero usa la búsqueda web para encontrar recomendaciones específicas para las herramientas, frameworks y bibliotecas del código base.
- Decir a los usuarios que pueden pedir más: Terminar indicando que pueden solicitar más recomendaciones para cualquier categoría específica.
Resumen de Tipos de Automatización
| Tipo | Mejor para |
|---|---|
| Hooks | Acciones automáticas en eventos de herramientas (formatear al guardar, lintear, bloquear ediciones) |
| Subagentes | Revisores/analizadores especializados que se ejecutan en paralelo |
| Skills | Experiencia empaquetada, flujos de trabajo y tareas repetibles (invocados por Claude o el usuario mediante /nombre-del-skill) |
| Plugins | Colecciones de skills que se pueden instalar |
| Servidores MCP | Integraciones con herramientas externas (bases de datos, APIs, navegadores, documentación) |
Flujo de Trabajo
Fase 1: Análisis del Código Base
Recopilar contexto del proyecto:
# Detectar tipo de proyecto y herramientas
ls -la package.json pyproject.toml Cargo.toml go.mod pom.xml 2>/dev/null
cat package.json 2>/dev/null | head -50
# Revisar dependencias para recomendaciones de servidores MCP
cat package.json 2>/dev/null | grep -E '"(react|vue|angular|next|express|fastapi|django|prisma|supabase|convex|stripe)"'
# Verificar configuración existente de Claude Code
ls -la .claude/ CLAUDE.md 2>/dev/null
# Analizar estructura del proyecto
ls -la src/ app/ lib/ tests/ components/ pages/ api/ 2>/dev/null
Indicadores Clave a Capturar:
| Categoría | Qué Buscar | Informa Recomendaciones Para |
|---|---|---|
| Lenguaje/Framework | package.json, pyproject.toml, patrones de import | Hooks, servidores MCP |
| Stack frontend | React, Vue, Angular, Next.js | Playwright MCP, skills de frontend |
| Stack backend | Express, FastAPI, Django | Herramientas de documentación de API |
| Base de datos | Prisma, Supabase, Convex, SQL sin procesar | Servidores MCP de base de datos / backend |
| APIs externas | Stripe, OpenAI, AWS SDKs | context7 MCP para documentación |
| Pruebas | Jest, pytest, configuraciones de Playwright | Hooks de testing, subagentes |
| CI/CD | GitHub Actions, CircleCI | Servidor MCP de GitHub |
| Seguimiento de incidencias | Referencias a Linear, Jira | Servidor MCP de gestor de incidencias |
| Patrones de doc | OpenAPI, JSDoc, docstrings | Skills de documentación |
Fase 2: Generar Recomendaciones
Basándose en el análisis, generar recomendaciones para todas las categorías:
A. Recomendaciones de Servidores MCP
Consulta references/mcp-servers.md para patrones detallados.
| Señal del Código Base | Servidor MCP Recomendado |
|---|---|
| Usa bibliotecas populares (React, Express, etc.) | context7 - Consulta de documentación en vivo |
| Frontend con necesidades de pruebas de UI | Playwright - Automatización/pruebas de navegador |
| Usa Supabase | Supabase MCP - Operaciones directas de base de datos |
| Usa Convex | Convex MCP - Introspección de despliegue en vivo, ejecutar consultas/mutaciones, gestionar variables de entorno y registros |
| Base de datos PostgreSQL/MySQL | Database MCP - Herramientas de consulta y esquema |
| Repositorio de GitHub | GitHub MCP - Issues, PRs, acciones |
| Usa Linear para incidencias | Linear MCP - Gestión de incidencias |
| Infraestructura AWS | AWS MCP - Gestión de recursos en la nube |
| Espacio de trabajo Slack | Slack MCP - Notificaciones de equipo |
| Persistencia de memoria/contexto | Memory MCP - Memoria entre sesiones |
| Seguimiento de errores Sentry | Sentry MCP - Investigación de errores |
| Contenedores Docker | Docker MCP - Gestión de contenedores |
B. Recomendaciones de Skills
Consulta references/skills-reference.md para más detalles.
Crear skills en .claude/skills/<nombre>/SKILL.md. Algunos también están disponibles mediante plugins:
| Señal del Código Base | Skill | Plugin |
|---|---|---|
| Construir plugins | skill-development | plugin-dev |
| Commits de Git | commit | commit-commands |
| React/Vue/Angular | frontend-design | frontend-design |
| Reglas de automatización | writing-rules | hookify |
| Planificación de funciones | feature-dev | feature-dev |
Skills personalizados a crear (con plantillas, scripts, ejemplos):
| Señal del Código Base | Skill a Crear | Invocación |
|---|---|---|
| Rutas de API | api-doc (con plantilla OpenAPI) | Ambos |
| Proyecto con base de datos | create-migration (con script de validación) | Solo usuario |
| Suite de pruebas | gen-test (con ejemplos de pruebas) | Solo usuario |
| Librería de componentes | new-component (con plantillas) | Solo usuario |
| Flujo de trabajo de PR | pr-check (con lista de verificación) | Solo usuario |
| Lanzamientos | release-notes (con contexto de git) | Solo usuario |
| Estilo de código | project-conventions | Solo Claude |
| Incorporación | setup-dev (con script de requisitos previos) | Solo usuario |
C. Recomendaciones de Hooks
Consulta references/hooks-patterns.md para configuraciones.
| Señal del Código Base | Hook Recomendado |
|---|---|
| Prettier configurado | PostToolUse: autoformatear al editar |
| ESLint/Ruff configurado | PostToolUse: autolintear al editar |
| Proyecto TypeScript | PostToolUse: verificar tipos al editar |
| Directorio de tests existe | PostToolUse: ejecutar pruebas relacionadas |
Archivos .env presentes | PreToolUse: bloquear ediciones de .env |
| Archivos de bloqueo presentes | PreToolUse: bloquear ediciones de archivos de bloqueo |
| Código sensible a la seguridad | PreToolUse: requerir confirmación |
D. Recomendaciones de Subagentes
Consulta references/subagent-templates.md para plantillas.
| Señal del Código Base | Subagente Recomendado |
|---|---|
| Código base grande (>500 archivos) | code-reviewer - Revisión de código en paralelo |
| Código de autenticación/pagos | security-reviewer - Auditorías de seguridad |
| Proyecto API | api-documenter - Generación de OpenAPI |
| Crítico para el rendimiento | performance-analyzer - Detección de cuellos de botella |
| Pesado en frontend | ui-reviewer - Revisión de accesibilidad |
| Necesita más pruebas | test-writer - Generación de pruebas |
E. Recomendaciones de Plugins
Consulta references/plugins-reference.md para plugins disponibles.
| Señal del Código Base | Plugin Recomendado |
|---|---|
| Productividad general | anthropic-agent-skills - Paquete de skills principales |
| Flujos de trabajo con documentos | Instalar skills de docx, xlsx, pdf |
| Desarrollo frontend | Plugin frontend-design |
| Construir herramientas de IA | mcp-builder para desarrollo de MCP |
Fase 3: Generar Informe de Recomendaciones
Formatear las recomendaciones de manera clara. Incluir solo 1-2 recomendaciones por categoría: las más valiosas para este código base específico. Omitir categorías que no sean relevantes.
## Recomendaciones de Automatización para Claude Code
He analizado tu código base y he identificado las mejores automatizaciones para cada categoría. Aquí están mis principales 1-2 recomendaciones por tipo:
### Perfil del Código Base
- **Tipo**: [lenguaje/entorno detectado]
- **Framework**: [framework detectado]
- **Bibliotecas Clave**: [bibliotecas relevantes detectadas]
---
### 🔌 Servidores MCP
#### context7
**Por qué**: [motivo específico basado en las bibliotecas detectadas]
**Instalar**: `claude mcp add context7`
---
### 🎯 Skills
#### [nombre del skill]
**Por qué**: [motivo específico]
**Crear**: `.claude/skills/[nombre]/SKILL.md`
**Invocación**: Solo usuario / Ambos / Solo Claude
**También disponible en**: plugin [nombre-del-plugin] (si aplica)
```yaml
---
name: [nombre-del-skill]
description: [lo que hace]
disable-model-invocation: true # para solo usuario
---
⚡ Hooks
[nombre del hook]
Por qué: [motivo específico basado en la configuración detectada]
Dónde: .claude/settings.json
🤖 Subagentes
[nombre del agente]
Por qué: [motivo específico basado en patrones del código base]
Dónde: .claude/agents/[nombre].md
¿Quieres más? Pide recomendaciones adicionales para cualquier categoría específica (por ejemplo, "muéstrame más opciones de servidores MCP" o "¿qué otros hooks ayudarían?").
¿Necesitas ayuda para implementar alguno? Solo pregunta y puedo ayudarte a configurar cualquiera de las recomendaciones anteriores.
## Marco de Decisión
### Cuándo Recomendar Servidores MCP
- Se necesita integración con servicios externos (bases de datos, APIs)
- Consulta de documentación para bibliotecas/SDKs
- Automatización o pruebas de navegador
- Integración con herramientas de equipo (GitHub, Linear, Slack)
- Gestión de infraestructura en la nube
### Cuándo Recomendar Skills
- Generación de documentos (docx, xlsx, pptx, pdf — también en plugins)
- Prompts o flujos de trabajo repetidos con frecuencia
- Tareas específicas del proyecto con argumentos
- Aplicar plantillas o scripts a tareas (los skills pueden incluir archivos de soporte)
- Acciones rápidas invocadas con `/nombre-del-skill`
- Flujos de trabajo que deben ejecutarse de forma aislada (`context: fork`)
**Control de invocación:**
- `disable-model-invocation: true` — Solo usuario (para efectos secundarios: desplegar, commit, enviar)
- `user-invocable: false` — Solo Claude (para conocimiento de fondo)
- Por defecto (omitir ambos) — Ambos pueden invocar
### Cuándo Recomendar Hooks
- Acciones repetitivas posteriores a la edición (formateo, linting)
- Reglas de protección (bloquear ediciones de archivos sensibles)
- Comprobaciones de validación (pruebas, verificación de tipos)
### Cuándo Recomendar Subagentes
- Se necesita experiencia especializada (seguridad, rendimiento)
- Flujos de trabajo de revisión en paralelo
- Controles de calidad en segundo plano
### Cuándo Recomendar Plugins
- Se necesitan múltiples skills relacionados
- Se desean paquetes de automatización preempaquetados
- Estandarización en todo el equipo
---
## Consejos de Configuración
### Configuración del Servidor MCP
**Compartición en equipo**: Incluir `.mcp.json` en el repositorio para que todo el equipo tenga los mismos servidores MCP
**Depuración**: Usar la bandera `--mcp-debug` para identificar problemas de configuración
**Requisitos previos a recomendar:**
- CLI de GitHub (`gh`) - habilita operaciones nativas de GitHub
- CLI de Puppeteer/Playwright - para servidores MCP de navegador
### Modo Headless (para CI/Automatización)
Recomendar Claude en modo headless para pipelines automatizados:
```bash
# Ejemplo de hook de pre-commit
claude -p "corrige errores de lint en src/" --allowedTools Edit,Write
# Pipeline de CI con salida estructurada
claude -p "<prompt>" --output-format stream-json | tu_comando
Permisos para Hooks
Configurar herramientas permitidas en .claude/settings.json:
{
"permissions": {
"allow": ["Edit", "Write", "Bash(npm test:*)", "Bash(git commit:*)"]
}
}