Skills

Workflows especializados que se activan por contexto semántico.

¿Qué son los Skills?

Los skills son conocimiento de dominio on-demand. A diferencia de CLAUDE.md que se carga siempre, los skills se cargan solo cuando son relevantes.

Cómo funcionan:

  1. Decís algo como “revisar PR” o “crear worktree”
  2. Claude detecta el skill relacionado por similitud semántica
  3. Te pregunta: “¿Querés que use el skill X?”
  4. Si confirmás, carga el workflow especializado

Lista de Skills

Skill Descripción Triggers
pr-reviewer Review de PRs con KISS/DRY/SOLID “revisar PR”, “code review”
git-reconciler Sincroniza branch con main “sync con main”, “actualizar branch”
worktree-manager Gestiona worktrees en .worktrees/ “crear worktree”, “listar worktrees”
setup-project Configura proyectos con npm run check “configurar proyecto”, “setup”
feature-planner Planifica features con entrevista “planificar feature”, “nueva funcionalidad”
doc-writer Crea documentos técnicos en /docs “crear documento”, “escribir spec”
doc-organizer Organiza docs en categorías “organizar docs”, “categorizar archivos”
llms-txt-generator Genera documentación para AI “crear llms.txt”, “documentar para AI”
claude-md-writer Escribe/mejora CLAUDE.md “crear CLAUDE.md”, “mejorar CLAUDE.md”
nextjs-project-starter Crea proyectos Next.js configurables “crear proyecto Next.js”
investor-profiler Determina perfil de inversor “perfil inversor”, “en qué invertir”
github-actions Configura GitHub Actions CI/CD “agregar CI”, “setup GitHub Actions”

Skills por Categoría

🔧 Git & Workflow

Skill Uso
pr-reviewer Revisión exhaustiva de PRs
git-reconciler Sincronización con main/master
worktree-manager Desarrollo paralelo con worktrees

📝 Documentación

Skill Uso
doc-writer Specs, planes, ADRs
doc-organizer Reorganizar docs existentes
claude-md-writer Optimizar CLAUDE.md
llms-txt-generator Docs para consumo de AI

🚀 Desarrollo

Skill Uso
setup-project Setup inicial de proyectos
feature-planner Planificación antes de codear
nextjs-project-starter Bootstrap de proyectos Next.js
github-actions CI/CD con GitHub Actions

💰 Otros

Skill Uso
investor-profiler Perfil de inversor y asset allocation

Cómo activar un Skill

Por trigger semántico (recomendado)

Usá las frases naturales que activan cada skill:

"Revisame el PR"
→ Activa pr-reviewer

"Necesito actualizar mi branch con main"
→ Activa git-reconciler

"Quiero agregar dark mode a la app"
→ Activa feature-planner

Invocación directa

Si el skill tiene un command asociado:

/plan        → Activa feature-planner
/reconcile   → Activa git-reconciler
/worktree    → Activa worktree-manager

Skill vs CLAUDE.md

CLAUDE.md Skills
Se carga siempre Se carga on-demand
Reglas universales Conocimiento específico
< 200 líneas Sin límite práctico
Code style, workflows Workflows complejos

Regla práctica: Si la información solo aplica a ciertos tipos de tareas, debería ser un skill.

Table of contents