Habilitación y Gestión de Skills en Claude Code, Cowork y Claude.ai
Una Skill creada una vez está pensada para funcionar de la misma manera en todas partes: las instrucciones dentro de SKILL.md no cambian dependiendo de si estás en Claude Code, Cowork o la aplicación web claude.ai.
Lo que sí difiere, de una superficie a otra, es dónde reside una Skill y cómo la activas.
Esta página te guía a través de la habilitación y organización de Skills en cada una de las tres, y qué comprobar cuando una Skill se comporta de manera diferente en un lugar que en otro.
Receta
- Identifica qué superficies utilizas realmente en tu día a día: Claude Code para una base de código, Cowork para tareas del espacio de trabajo en equipo, claude.ai para chat general, ya que cada una tiene su propio paso de habilitación.
- En Claude Code, coloca la carpeta de la Skill en la ubicación de Skills del proyecto o a nivel de usuario que espera la herramienta, para que sea detectada para ese repositorio o en todos tus proyectos.
- En Cowork, añade la Skill al área de Skills del espacio de trabajo del equipo, donde estará disponible para las conversaciones dentro de ese espacio de trabajo.
- En claude.ai, añade la Skill a través de la configuración de Skills de tu cuenta, donde estará disponible en tus conversaciones personales.
- Después de habilitarla en cualquier superficie, prueba con una solicitud real y natural en lugar de un mensaje genérico, y confirma que la salida coincide con lo que describen las instrucciones de la Skill.
- Revisa periódicamente la lista de cada superficie: deshabilitar Skills que ya no utilizas mantiene la detección más limpia y evita descripciones superpuestas que compiten por las mismas tareas.
Ejemplo Práctico
Habilitar la misma Skill en las tres superficies se ve así en la práctica.
Skill: "code-review-checklist"
Objetivo: disponible en Claude Code (este repositorio), Cowork (espacio de trabajo del equipo)
y claude.ai (cuenta personal).
1. Claude Code: añade la carpeta de la Skill a la ubicación de Skills del proyecto
para que se aplique siempre que trabajes en este repositorio.
2. Cowork: añade la misma carpeta de la Skill al área de Skills del espacio de trabajo del equipo
para que los compañeros de equipo también la reciban, no solo tú.
3. claude.ai: añade la Skill a través de la configuración de la cuenta personal para que esté
disponible en el chat normal, fuera de cualquier espacio de trabajo o repositorio.
4. Prueba cada superficie por separado: pide una revisión de código de una manera que lo
formularías de forma natural, y confirma que el formato de lista de verificación aparece.Cada paso es una acción de habilitación separada, aunque el archivo SKILL.md subyacente sea idéntico en las tres: no es necesario reescribir nada del contenido de la Skill por superficie.
El paso de prueba es más importante de lo que parece: una Skill habilitada correctamente en una superficie pero nunca probada allí puede fallar silenciosamente si la habilitación de esa superficie no se completó, y la única forma de detectarlo es con una solicitud real.
Profundización
La razón por la que la habilitación difiere por superficie, mientras que el comportamiento una vez cargada no lo hace, se reduce a lo que controla cada superficie.
Claude Code suele estar limitado a un proyecto o base de código, por lo que su ubicación de Skills a menudo está ligada a ese proyecto, con una opción para Skills que se aplican a todos tus proyectos.
Cowork se basa en espacios de trabajo de equipo compartidos, por lo que su área de Skills está naturalmente limitada a un espacio de trabajo: una Skill añadida allí estará disponible para todos los que trabajen en ese espacio, no solo para la persona que la añadió.
claude.ai está limitado a tu cuenta personal, por lo que las Skills añadidas allí te siguen en tus conversaciones personales, independientemente de cualquier equipo o repositorio.
Nada de eso cambia la forma en que funciona la detección una vez que una Skill está habilitada: Claude sigue comprobando el mismo campo description contra el mismo tipo de tarea entrante, utilizando la misma lógica de coincidencia, independientemente de la superficie en la que se esté produciendo la conversación.
Lo que sí puede diferir genuinamente entre superficies es el acceso a las herramientas: allowed-tools en el frontmatter de una Skill interactúa con las herramientas que esa superficie expone en primer lugar, por lo que una Skill que hace referencia a una herramienta solo disponible en Claude Code no podrá utilizarla dentro de la interfaz de chat de claude.ai, incluso si la Skill está habilitada allí.
Gestionar una biblioteca de Skills en crecimiento en tres superficies es principalmente una cuestión de mantener una versión canónica de cada Skill y decidir deliberadamente dónde necesita ser habilitada, en lugar de permitir que copias ligeramente diferentes se desvíen en diferentes superficies.
Posibles Problemas
- Habilitada en una superficie, probada en otra. Confirmar que una Skill funciona en claude.ai no garantiza que se comporte de la misma manera en Claude Code si nunca se habilitó realmente allí.
- Skills con ámbito de equipo confundidas con personales. Una Skill añadida a un espacio de trabajo de Cowork está disponible para las conversaciones de ese espacio de trabajo, no automáticamente para tu cuenta personal de claude.ai.
- Referencias a herramientas que no existen en todas las superficies. Una Skill escrita pensando en una herramienta específica de Claude Code puede cargarse correctamente en otro lugar pero no poder utilizar realmente esa capacidad.
- Copias obsoletas que se desvían. Editar las instrucciones de una Skill en una superficie sin actualizar la misma Skill en otro lugar conduce a un comportamiento inconsistente entre superficies con el tiempo.
- Asumir que es necesario volver a habilitar después de cada edición. La mayoría de las ediciones en el
SKILL.mdde una Skill ya habilitada surten efecto al guardar, sin un paso de re-habilitación separado; pero vale la pena confirmarlo en cada superficie en lugar de asumirlo.
Alternativas
- Instrucciones Personalizadas en lugar de una Skill, cuando el objetivo es una preferencia permanente que debe aplicarse a cada conversación en una superficie, no una receta activada por tareas.
- El contexto persistente de un Proyecto, cuando el objetivo es información ligada a un espacio de trabajo en curso en lugar de una tarea repetible que deseas tener disponible en todas partes.
- Mantener una Skill habilitada solo en una superficie, cuando una tarea genuinamente solo surge en un contexto, por ejemplo, un flujo de trabajo específico de Claude Code sin un equivalente en el chat normal.
Preguntas Frecuentes
¿Necesito reescribir una Skill de forma diferente para cada superficie?
- No: la misma carpeta
SKILL.mdfunciona en Claude Code, Cowork y claude.ai sin cambios en su contenido.
¿Dónde residen las Skills en Claude Code?
- En una ubicación de Skills a nivel de proyecto o de usuario que Claude Code busca, por lo que una Skill puede aplicarse a un repositorio o a todos tus proyectos dependiendo de dónde se coloque.
¿Quién puede usar una Skill que añado a un espacio de trabajo de Cowork?
- Todos los que trabajan en ese espacio de trabajo de equipo, no solo la persona que la añadió; está limitada al espacio de trabajo, no a una cuenta individual.
¿Habilitar una Skill en claude.ai la hace disponible también en Claude Code?
- No: cada superficie tiene su propio paso de habilitación; una Skill debe añadirse por separado dondequiera que la desees disponible.
¿Por qué mi Skill funcionó en una superficie pero no en otra?
- Las causas más comunes son que la Skill aún no esté realmente habilitada en esa superficie, o que una herramienta referenciada no esté disponible allí.
Si edito las instrucciones de una Skill, ¿necesito volver a habilitarla en todas partes?
- Generalmente no: las ediciones en una Skill ya habilitada suelen aplicarse al guardar, pero vale la pena confirmarlo con una prueba real en cada superficie después de un cambio significativo.
¿Puede una Skill limitarse a un solo proyecto en Claude Code?
- Sí: la colocación de Skills a nivel de proyecto mantiene una Skill limitada a ese repositorio, separada de las Skills que se aplican a todos tus proyectos.
¿Hay un límite en la cantidad de Skills que puedo tener habilitadas?
- Los límites prácticos dependen de tu plan y de la superficie; el límite más relevante en la práctica es la fiabilidad de la detección, ya que demasiadas descripciones superpuestas hacen que la coincidencia sea menos predecible independientemente de cualquier límite estricto.
¿Debería deshabilitar las Skills que no estoy usando?
- Es una buena práctica: menos descripciones, más distintas, hacen que la detección sea más fiable, y una Skill no utilizada solo añade posibles solapamientos.
¿Puedo saber para qué superficie se construyó originalmente una Skill?
- No desde la Skill misma:
SKILL.mdno registra una superficie de origen, ya que las Skills están diseñadas para ser portátiles en todas ellas.
Relacionado
- Conceptos Básicos de Agent Skills - creación de tu primera Skill antes de decidir dónde habilitarla
- Skills vs Proyectos vs Instrucciones Personalizadas: ¿Cuál es la Diferencia? - cuándo una Skill es la herramienta adecuada frente a un Proyecto o Instrucciones Personalizadas
- Anatomía de un Archivo SKILL.md - el campo
allowed-toolsreferenciado en la Profundización anterior - Señales de que Claude no está descubriendo tu Skill - diagnóstico de una Skill que parece habilitada pero no se activa
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente: verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.