Cargando
En esta lecciónAl finalizar, podrás
  • Comparte skills con tu equipo confirmándolos en un repositorio de Git
  • Distribuye skills entre proyectos mediante plugins y marketplaces
  • Implementa skills en toda la organización usando configuraciones administradas empresariales
  • Configura subagentes personalizados para usar skills específicos

Compartir skills

Cargando

Compartir skills · 4 min

ResumenTranscripción

Los skills se vuelven mucho más valiosos cuando se comparten entre un equipo o una organización. Este video cubre los tres métodos principales de distribución —commits al repositorio, plugins y configuraciones administradas empresariales— 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 los skills automáticamente.

Puntos clave

  • Los skills de proyecto en .claude/skills se comparten automáticamente a través de Git: cualquiera que clone el repositorio los obtiene
  • Los plugins te permiten distribuir skills entre repositorios a través de marketplaces para un uso más amplio por parte de la comunidad
  • Las configuraciones administradas empresariales despliegan skills en toda la organización con la máxima prioridad, ideal para estándares obligatorios y cumplimiento normativo
  • Los subagentes no ven los skills que ya has invocado. Si tienen la herramienta Skill, aún pueden encontrar e invocar skills
  • Los agentes integrados (como Explore y Plan) no precargan skills. Solo los subagentes personalizados pueden listar los skills que se cargarán al inicio, en su campo skills

Los skills se vuelven mucho más valiosos cuando se comparten. Un skill de revisión de PR que solo tú usas es útil, pero ese mismo skill compartido con 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.

Confirmar skills en tu repositorio

El método de compartir más simple es confirmar (commit) los skills directamente en tu repositorio. Colócalos en .claude/skills, y cualquiera que clone el repositorio obtiene esos skills automáticamente, sin necesidad de instalación adicional.

Cuando envías (push) 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.

Descubrir plugins de Claude Code, una lista de plugins con capacidad de búsqueda de claude-plugins-official con recuentos de instalación.

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

Implementación empresarial mediante configuraciones administradas

Los administradores pueden implementar skills en toda la organización mediante configuraciones administradas. Cada skill se coloca en .claude/skills/ dentro del directorio de configuraciones administradas en cada máquina, por ejemplo, /etc/claude-code/.claude/skills/ en Linux. Los skills empresariales tienen la máxima prioridad: sobrescriben los skills personales y de proyecto que tengan el mismo nombre.

managed-settings.json con variables de entorno de telemetría, dos anuncios de la empresa y una lista strictKnownMarketplaces.

Las configuraciones administradas también controlan los plugins. Por ejemplo, strictKnownMarketplaces limita desde qué marketplaces las personas pueden agregar e instalar plugins. La captura de pantalla anterior incluye una entrada npm, que no coincide con nada, por lo que este ejemplo utiliza una entrada url en su lugar:

json
"strictKnownMarketplaces": [
  {
    "source": "github",
    "repo": "acme-corp/approved-plugins"
  },
  {
    "source": "url",
    "url": "https://plugins.example.com/marketplace.json"
  }
]

La implementación empresarial es la opción adecuada 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: un subagente no ve los skills que ya has invocado. Cuando delegas una tarea a un subagente, este comienza con un contexto nuevo y limpio, a menos que sea un fork, que comienza con una copia de tu conversación. Un subagente que comienza desde cero aún puede encontrar e invocar skills a través de la herramienta Skill, siempre que tenga esa herramienta.

Hay distinciones importantes que comprender:

  • Los agentes integrados (como Explore y Plan) no precargan skills
  • Los subagentes personalizados que defines pueden precargar los skills que enumeras en su campo skills. Si le asignas una lista tools, mantén Skill en ella para que el subagente aún pueda invocar skills no listados
  • Los skills precargados se cargan por completo 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 escribir el archivo tú mismo o pedirle a Claude que lo cree por ti. Si .claude/agents no existía cuando se inició tu sesión, reinicia Claude Code para cargar el nuevo subagente. La captura de pantalla a continuación muestra el asistente /agents, que fue eliminado en Claude Code v2.1.198.

Indicación de nuevo agente de Claude Code, con texto escrito que comienza "Quiero que revises el frontend en busca de cualquier problema de accesibilidad".

El campo skills del archivo del agente indica 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 en este subagente, tiene ambos skills cargados y los aplica en cada revisión. Primero asegúrate de que los skills existan en tu directorio .claude/skills, y 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 una delegación de tareas aislada con experiencia específica
  • Diferentes subagentes necesitan diferentes skills (revisor de frontend frente a 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 distribución (repositorio, plugin, empresarial) tiene más sentido para los skills que has estado pensando en crear?
  • ¿Tienes flujos de trabajo en los que subagentes personalizados con skills específicos mejorarían la consistencia en el trabajo delegado?

Qué sigue

En la última lección, aprenderás a solucionar problemas comunes de los 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.