Habilidades personales vs. de proyecto

Las habilidades pueden ubicarse en uno de tres lugares: personales, de proyecto o de plugin.

Las habilidades personales residen en ~/.claude/skills/<skill-name>/SKILL.md y están disponibles en todos tus proyectos. Las habilidades específicas del proyecto se almacenan en .claude/skills/<skill-name>/SKILL.md dentro del directorio del proyecto. Estas habilidades de proyecto están destinadas a ser controladas por versiones, haciéndolas accesibles a tu equipo. Las habilidades de plugin se encuentran dentro de la estructura de directorios de un plugin en <plugin>/skills/<skill-name>/SKILL.md.

Cuando las habilidades comparten el mismo nombre en estas ubicaciones, la precedencia se determina de la siguiente manera: las habilidades empresariales anulan las habilidades personales, y las habilidades personales anulan las habilidades de proyecto. Las habilidades en cualquiera de estos niveles también tienen precedencia sobre las habilidades empaquetadas con el mismo nombre. Por ejemplo, una habilidad personalizada de revisión de código en el directorio .claude/skills/ de tu proyecto reemplazará la versión empaquetada predeterminada.

Las habilidades de plugin usan un espacio de nombres plugin-name:skill-name, lo que evita conflictos de nombres con habilidades en otros niveles. Las habilidades de proyecto se cargan desde directorios .claude/skills/ comenzando desde tu directorio de trabajo actual y subiendo a través de los directorios padre hasta la raíz del repositorio. Esto asegura que las habilidades definidas a nivel de repositorio sean accesibles incluso cuando se trabaja en subdirectorios.

Las habilidades también pueden cargarse bajo demanda desde directorios .claude/skills/ anidados. Cuando Claude interactúa con archivos en un subdirectorio, cualquier habilidad dentro del .claude/skills/ de ese subdirectorio estará disponible. Este mecanismo es particularmente útil en monorepos, donde los paquetes individuales pueden proporcionar sus propias habilidades. Si una habilidad anidada tiene el mismo nombre que otra habilidad, ambas permanecen disponibles, y la habilidad anidada se referencia usando su ruta, por ejemplo, /apps/web:deploy.

Una entrada <skill-name> también puede ser un enlace simbólico a un directorio ubicado en otra parte de tu sistema de archivos. Una excepción a las reglas típicas de acceso a archivos ocurre con el flag --add-dir y el comando /add-dir: un directorio .claude/skills/ dentro de un directorio añadido se carga automáticamente, a diferencia de los directorios añadidos a través de la configuración permissions.additionalDirectories.