Compartir skills

Compartir skills · 4 min

ResumenTranscripción

Las skills se vuelven mucho más valiosas cuando se comparten en un equipo u organización. Este video cubre los tres métodos principales de distribución —commits al repositorio, plugins y configuración administrada empresarial— y explica cómo configurar subagentes personalizados para usar skills. Aprenderás qué enfoque se ajusta a cada escenario y cómo manejar un detalle importante: los subagentes no heredan las skills automáticamente.

Puntos clave

Las skills de proyecto en .claude/skills se comparten automáticamente a través de Git: cualquiera que clone el repositorio las obtiene
Los plugins te permiten distribuir skills entre repositorios mediante marketplaces para un uso más amplio por parte de la comunidad
La configuración administrada empresarial implementa skills en toda la organización con la máxima prioridad, ideal para estándares obligatorios y cumplimiento normativo
Los subagentes no ven tus skills automáticamente: debes enumerarlas explícitamente en el campo skills del frontmatter de un agente personalizado
Los agentes integrados (Explorer, Plan, Verify) no pueden acceder a las skills en absoluto: solo los subagentes personalizados definidos en .claude/agents pueden hacerlo

Las skills se vuelven mucho más valiosas cuando se comparten. Una skill de revisión de PR que solo tú usas es útil, pero esa misma skill compartida en todo tu equipo estandariza la revisión de código y crea una experiencia consistente en toda tu organización. Veamos las diferentes formas en que puedes distribuir skills.

Hacer commit de skills en tu repositorio

El método de compartición más simple es hacer commit de las skills directamente en tu repositorio. Colócalas en .claude/skills, y cualquiera que clone el repositorio obtendrá esas skills automáticamente, sin necesidad de instalación adicional.

Cuando haces push de actualizaciones, todos las reciben en el siguiente pull. Este enfoque funciona bien para:

Estándares de codificación del equipo
Flujos de trabajo específicos del proyecto
Skills que hacen referencia a la estructura de tu base de código

El directorio .claude contiene tus agentes, hooks, skills y configuraciones, todo bajo control de versiones y compartido con el equipo mediante los flujos de trabajo normales de Git.

Distribuir skills mediante plugins

Los plugins son una forma de extender Claude Code con funcionalidad personalizada diseñada para compartirse entre equipos y proyectos. En tu proyecto de plugin, crea un directorio skills que siga una estructura de archivos similar a la del directorio .claude: cada skill obtiene su propia carpeta con un archivo SKILL.md dentro.

Después de distribuir tu plugin a un marketplace, otros usuarios pueden descubrirlo e instalarlo en Claude Code por sí mismos.

Este enfoque es mejor cuando tus skills no son demasiado específicas del proyecto y pueden ser útiles para miembros de la comunidad más allá de tu equipo inmediato.

Implementación empresarial mediante configuración administrada

Los administradores pueden implementar skills en toda la organización mediante la configuración administrada. Las skills empresariales tienen la máxima prioridad: anulan las skills personales, de proyecto y de plugins que tengan el mismo nombre.

El archivo de configuración administrada admite funciones como strictKnownMarketplaces para controlar desde dónde se pueden instalar los plugins:

json

"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo": "acme-corp/approved-plugins"
  },
  {
    "source": "npm",
    "package": "@acme-corp/compliance-plugins"
  }
]

Esta es la opción correcta para estándares obligatorios, requisitos de seguridad, flujos de trabajo de cumplimiento normativo y prácticas de codificación que deben ser consistentes en toda la organización. La palabra clave aquí es "deben".

Skills y subagentes

Aquí hay algo que sorprende a la gente: los subagentes no ven tus skills automáticamente. Cuando delegas una tarea a un subagente, este comienza con un contexto nuevo y limpio.

Hay distinciones importantes que entender:

Los agentes integrados (como Explorer, Plan y Verify) no pueden acceder a las skills en absoluto
Los subagentes personalizados que defines sí pueden usar skills, pero solo cuando las enumeras explícitamente
Las skills se cargan cuando el subagente se inicia, no bajo demanda como en la conversación principal

Para crear un subagente personalizado con skills, agrega un archivo markdown de agente en .claude/agents. Puedes usar el comando /agents en Claude Code para crear uno de forma interactiva:

El archivo de agente generado incluye un campo skills que enumera qué skills cargar. Así es como se ve el frontmatter:

yaml

---
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
---

Cuando delegas a este subagente, este tiene ambas skills cargadas y las aplica a cada revisión. Primero asegúrate de que las skills existan en tu directorio .claude/skills, luego crea un nuevo subagente o agrega el campo skills al archivo markdown de un agente existente.

Este patrón funciona muy bien cuando:

Quieres delegación de tareas aislada con experiencia específica
Diferentes subagentes necesitan diferentes skills (revisor de frontend vs. revisor de backend)
Quieres hacer cumplir estándares en el trabajo delegado sin depender de prompts

Reflexión de la lección

¿Qué método de compartición (repositorio, plugin, empresarial) tiene más sentido para las skills que has estado pensando en crear?
¿Tienes flujos de trabajo donde subagentes personalizados con skills específicas mejorarían la consistencia en el trabajo delegado?

Qué sigue

En la lección final, aprenderás a solucionar problemas comunes de las skills: desde skills que no se activan, hasta conflictos de prioridad y errores en tiempo de ejecución, con una lista de verificación práctica que puedes consultar en cualquier momento.