Plugins Locales en Claude Code: Por Qué .claude/skills Puede Ser la Nueva Carpeta Más Importante de tu Repo

Durante los últimos dos años hemos hablado constantemente sobre modelos.

Más contexto.

Más tokens.

Más benchmarks.

Más capacidad de razonamiento.

Pero una de las novedades más interesantes de Claude Code no tiene nada que ver con el modelo.

Tiene que ver con una carpeta.

.claude/skills

La última release de Claude Code introdujo carga automática de plugins desde esa ubicación, agregó el comando claude plugin init <name> para generar scaffolding y mejoró la experiencia alrededor de /plugin.

Puede parecer un cambio menor.

No lo es.

Porque apunta a una transición mucho más profunda: Claude Code está evolucionando desde un agente generalista hacia una plataforma extensible de workflows.

Y eso podría cambiar la forma en que los equipos organizan conocimiento operativo dentro de sus repositorios.


El problema de los agentes generalistas

Los modelos actuales saben muchas cosas.

Pero rara vez saben cómo trabaja específicamente tu equipo.

No conocen:

  • Tu flujo de deployment.
  • Tus convenciones de arquitectura.
  • Tus reglas de testing.
  • Tus procedimientos de seguridad.
  • Tus estándares de documentación.
  • Tus prácticas de revisión.

Cada vez que abrimos una sesión nueva tenemos que volver a explicar parte de ese contexto.

Incluso con memoria, repositorios indexados y ventanas de contexto enormes, sigue existiendo una diferencia importante entre conocimiento general y conocimiento operativo.

Los agentes entienden código.

Los equipos entienden procesos.

Y esa brecha es precisamente donde aparecen los skills.


¿Qué es realmente un skill?

La forma más simple de entenderlo es pensar en un skill como una capacidad especializada empaquetada dentro del repositorio.

No es simplemente un prompt.

No es únicamente documentación.

No es solo una automatización.

Es una combinación de:

  • Contexto.
  • Instrucciones.
  • Herramientas.
  • Procedimientos.
  • Conocimiento específico.

Todo versionado junto al código.

Por ejemplo:

.claude/
└── skills/
    ├── security-review/
    ├── release-checklist/
    ├── migration-validator/
    ├── api-documentation/
    └── incident-response/

Cada skill puede enseñarle al agente cómo ejecutar una tarea concreta siguiendo las reglas de ese proyecto.


Del prompt engineering al workflow engineering

Durante mucho tiempo la conversación estuvo centrada en prompts.

La pregunta era:

¿Cuál es el mejor prompt?

Ahora la pregunta empieza a cambiar:

¿Cuál es el mejor workflow?

Ese cambio es importante.

Porque los prompts viven en conversaciones.

Los workflows viven en repositorios.

Y los repositorios son donde los equipos colaboran.

Un skill bien diseñado puede capturar años de experiencia operativa y ponerla a disposición de cualquier desarrollador que trabaje sobre el proyecto.


La nueva infraestructura invisible

Los mejores skills probablemente no serán los más complejos.

Serán los más repetidos.

Pensemos en tareas que ocurren constantemente:

Revisión de seguridad

/plugin security-review

El agente:

  • Busca secretos expuestos.
  • Revisa permisos.
  • Verifica dependencias.
  • Evalúa configuraciones críticas.
  • Genera un reporte estandarizado.

Validación de releases

/plugin release-checklist

El agente:

  • Ejecuta verificaciones.
  • Revisa changelogs.
  • Comprueba migraciones.
  • Valida documentación.
  • Genera un resumen de riesgos.

Auditoría arquitectónica

/plugin architecture-review

El agente:

  • Detecta violaciones de patrones.
  • Revisa dependencias entre módulos.
  • Evalúa límites de contexto.
  • Sugiere mejoras.

Ninguna de estas tareas depende exclusivamente del modelo.

Dependen principalmente del proceso.


Lo interesante no es la automatización

Es la portabilidad.

Hasta ahora gran parte del conocimiento operativo vive en lugares dispersos:

  • Wikis.
  • Notion.
  • Confluence.
  • Documentos internos.
  • Mensajes de Slack.
  • Memoria tribal.

Los skills permiten mover parte de ese conocimiento directamente al repositorio.

Eso significa que el conocimiento viaja junto con el código.

Cuando alguien clona un proyecto, también obtiene los workflows.

Cuando alguien crea un fork, también hereda los procesos.

Cuando alguien incorpora un nuevo desarrollador, los skills forman parte del onboarding.


La analogía con GitHub Actions

Cuando GitHub Actions apareció, muchos pensaron que era simplemente una forma más cómoda de ejecutar scripts.

Con el tiempo se convirtió en infraestructura crítica.

Hoy nadie discute la importancia de:

.github/workflows/

Porque ahí vive gran parte de la automatización del ciclo de desarrollo.

.claude/skills podría recorrer un camino parecido.

No como reemplazo de GitHub Actions.

Sino como la capa donde viven los procedimientos inteligentes del equipo.


El nacimiento del repositorio programable

Históricamente un repositorio contenía:

  • Código.
  • Configuración.
  • Documentación.

Ahora empieza a contener algo más.

Comportamiento.

No comportamiento del software.

Comportamiento del agente.

Estamos viendo los primeros pasos hacia repositorios que no solo almacenan código, sino que también enseñan a los agentes cómo trabajar dentro de ellos.

Ese cambio es enorme.

Porque transforma el repositorio de una estructura pasiva en una fuente activa de conocimiento operativo.


Por Qué Esto Importa para Equipos Lean

Los equipos más beneficiados probablemente no serán las grandes empresas.

Serán los equipos que necesitan escalar conocimiento sin escalar reuniones.

Cada vez que un skill captura una práctica operativa:

  • Disminuye el tiempo de onboarding.
  • Reduce errores repetitivos.
  • Estandariza procesos.
  • Aumenta consistencia.
  • Multiplica experiencia.

Un desarrollador nuevo puede aprovechar procedimientos construidos por el equipo durante meses o años.

Y el agente puede aplicarlos automáticamente.


La Señal Más Importante

La verdadera noticia no es que Claude Code agregue plugins.

La noticia es que Anthropic parece estar apostando por una arquitectura donde el valor no vive únicamente en el modelo.

Vive en la capa de especialización.

Los modelos seguirán mejorando.

Pero la diferenciación real podría surgir de los skills que cada organización construya encima de ellos.

Del mismo modo que todos usamos Git, pero cada empresa tiene workflows distintos.


Conclusión

Durante años pensamos que el futuro de los agentes dependía principalmente de modelos cada vez más inteligentes.

Claude Code está sugiriendo algo diferente.

Tal vez el próximo salto de productividad no venga de un modelo mejor.

Tal vez venga de repositorios capaces de enseñar a los agentes cómo trabajar.

Si esa visión se materializa, .claude/skills podría terminar siendo una de las carpetas más importantes de cualquier proyecto moderno.

No porque contenga código.

Sino porque contendrá la experiencia acumulada del equipo.