Dónde busca Claude Code las skills
Claude Code carga skills de varios lugares. La tabla de la documentación los enumera:
- Personal:
~/.claude/skills/<nombre-de-la-skill>/SKILL.md, para todos tus proyectos en esta máquina. - Proyecto:
.claude/skills/<nombre-de-la-skill>/SKILL.mden un repositorio. - Anidado: una carpeta
.claude/skillsdentro de un subdirectorio. - Enterprise: skills que tu organización despliega a través de configuraciones gestionadas.
- Plugin: skills dentro de un plugin habilitado, nombradas con el prefijo del plugin.
- Cuenta de claude.ai: skills habilitadas para tu cuenta de claude.ai.
El último punto es de lo que trata esta guía. Una skill que creaste en la aplicación web o en el chat de escritorio de Claude no reside en una carpeta que tú creaste. Reside en tu cuenta, y Claude Code descarga una copia en las sesiones donde puede.
Para ver qué se ha cargado, ejecuta /skills. La documentación indica que las skills sincronizadas se enumeran bajo un grupo llamado claude.ai sync.
Cuándo se sincronizan las skills desde claude.ai
La documentación dice que la sincronización se aplica si usas Cowork o sesiones en la nube, "o si inicias sesión en Claude Code en tu terminal con una cuenta de claude.ai".
En una sesión de terminal, así es como funciona: "Cuando comienza la sesión, Claude Code descarga las skills de tu cuenta en ~/.claude/skills/synced/ en segundo plano, luego verifica claude.ai en busca de cambios mientras la sesión se ejecuta".
Las verificaciones no se ejecutan constantemente. Mientras tú o Claude están trabajando, se realiza una verificación aproximadamente cada 10 minutos. Mientras la sesión está inactiva, aproximadamente cada 40 minutos. Cuando vuelves a escribir después de un largo período de inactividad, Claude Code verifica en unos pocos minutos.
Dos detalles explican por qué una skill aparece tarde.
La sincronización no retrasa el inicio. La documentación dice: "La sincronización nunca retrasa el inicio, porque Claude espera la descarga de una skill solo cuando invoca esa skill". Una skill que acabas de añadir en claude.ai puede tardar un ciclo de verificación en llegar.
Las ejecuciones cortas no interactivas pueden omitir nuevas skills. Una ejecución rápida puede terminar antes de que se descargue una skill recién añadida, y una sesión posterior la recogerá. La documentación describe una configuración que hace que una ejecución no interactiva espere a la lista de skills.
Qué skills se sincronizan depende de tu configuración de claude.ai. Algunas de las skills propias de Anthropic, como pdf y xlsx, siempre se sincronizan. Para el resto, la skill debe estar activada en tu configuración de skills en claude.ai.
Sesiones que no se sincronizan
Esto es lo primero que debes verificar cuando falta una skill de claude.ai en la terminal. La documentación enumera las sesiones donde Claude Code no se sincroniza:
- Sesiones sin un inicio de sesión con
/login, como las que se autentican con una clave API, o donde una variable de token de autenticación o un script de ayuda de clave API proporciona la credencial. - Sesiones que no obtienen feature flags, como una en Amazon Bedrock, o una donde el tráfico no esencial está desactivado.
- Modo bare y modo safe.
- Sesiones donde las configuraciones gestionadas bloquean las skills a fuentes de plugins, o donde una lista de fuentes de configuración omite las configuraciones de usuario.
Un caso más se aplica si inicias sesión a mitad de camino: "Si inicias sesión con /login durante una sesión, reinicia Claude Code para comenzar la sincronización".
Las skills sincronizadas anteriormente no se pierden cuando una sesión no puede sincronizarse. La documentación dice: "Las skills que una sesión anterior sincronizó permanecen en el disco". Claude Code las carga en sesiones posteriores que hayan iniciado sesión en la misma cuenta, incluso sin conexión a claude.ai.
Por el lado de claude.ai, las skills también dependen de la configuración de la cuenta. El centro de ayuda de Anthropic dice que las skills requieren que la ejecución de código esté habilitada, y en los planes Enterprise, un propietario debe habilitar las skills para la organización.
Por qué una skill local con el mismo nombre gana
Cada skill sincronizada tiene dos nombres. La documentación explica: "Puedes invocar una skill sincronizada por su nombre corto, /<nombre>, o por su nombre completo, /anthropic-skills:<nombre>".
Cuando algo más ya usa el nombre corto, ese otro elemento gana. La documentación da un ejemplo: "Con una skill deploy local y una deploy sincronizada, /deploy ejecuta la skill local y /anthropic-skills:deploy ejecuta la sincronizada".
El otro comando puede ser casi cualquier cosa: un comando integrado, una skill empaquetada, una skill personal o de proyecto, un archivo en .claude/commands/, una skill de plugin o un prompt de MCP. La comparación también ignora mayúsculas y minúsculas y algunas diferencias de espaciado, por lo que una skill sincronizada llamada Commit y una skill local llamada commit cuentan como el mismo nombre.
Es por esto que una skill puede parecer faltante cuando en realidad está allí bajo su nombre completo. Ejecuta /skills. La documentación dice que una nota debajo de la lista explica cada skill sincronizada que perdió su nombre corto, y si una de tus propias skills o archivos de comando en ~/.claude/ usa el nombre, la nota indica qué renombrar o eliminar para liberarlo.
Por qué las ediciones en la carpeta sincronizada se sobrescriben
La carpeta sincronizada es un destino de descarga, no un lugar para editar. La documentación es explícita: "Si tú o Claude editan un archivo bajo ~/.claude/skills/synced/, el cambio no se guarda en tu cuenta de claude.ai, y una sincronización posterior puede sobrescribirlo o eliminarlo".
Su instrucción es igual de clara: "Para cambiar una skill sincronizada, actualízala en claude.ai; la próxima sincronización descargará la nueva versión".
La misma lógica se aplica al eliminar. Si eliminas la carpeta de una skill sincronizada a mano mientras aún está habilitada en claude.ai, la próxima sincronización la descargará de nuevo. Para eliminarla, desactívala en claude.ai.
Si prefieres trabajar en una copia localmente, colócala en tu carpeta de skills personales bajo un nombre de carpeta diferente. No nombres una carpeta como synced. Claude Code reserva ese nombre y omitirá cualquier skill que crees allí.
Qué cambia cuando una skill sincronizada se ejecuta en la terminal
Una skill sincronizada puede cargarse y aun así comportarse de manera diferente a la versión de claude.ai. La documentación describe cómo Claude Code trata el cuerpo de una skill sincronizada en una sesión de terminal o VS Code: no ejecuta líneas que inyecten salida de shell, no adjunta archivos referenciados con @ y no rellena marcadores de posición como el directorio del proyecto o el ID de la sesión. Estos llegan a Claude como texto plano.
En una sesión en la nube, el cuerpo se comporta como una skill local, porque la sesión se ejecuta en un contenedor aislado. En una sesión de Cowork en tu escritorio, las líneas de shell se reemplazan con un marcador de posición.
Si una skill depende de alguna de estas funciones, puede funcionar en un lugar y parecer rota en otro.
Skills que existen solo en tu máquina
La sincronización funciona en una sola dirección. Las skills en ~/.claude/skills/ en tu computadora no viajan a claude.ai.
Eso importa para las sesiones de Cowork y en la nube. La documentación dice que estas "no leen ~/.claude/skills/ en tu máquina". En su lugar, cargan las skills habilitadas para tu cuenta de claude.ai.
El resultado puede parecer una skill faltante en la otra dirección. La documentación señala que si una skill existe solo en tu carpeta personal, Claude Code informa que no se encontró cuando una tarea programada en la nube la invoca, porque cada ejecución comienza como una sesión en la nube fresca. Para que una skill personal esté disponible allí, habilítala en tu cuenta de claude.ai. Para sesiones en la nube fuera de hilos de proyecto, también puedes confirmarla (commit) en el .claude/skills/ del repositorio.
Las tareas programadas de escritorio son diferentes. Se ejecutan en tu máquina, por lo que sí cargan ~/.claude/skills/.
Skills que se cargan tarde o no se activan
Otras pocas causas hacen que una skill parezca faltante incluso cuando su archivo está en su lugar.
Las skills anidadas se cargan bajo demanda. Las skills en una carpeta .claude/skills debajo de donde iniciaste Claude Code no se cargan al inicio. La documentación dice que se cargan "la primera vez que Claude lee o edita un archivo en ese subdirectorio". Ejecuta /add-dir con el subdirectorio para cargarlas antes.
Las nuevas skills pueden necesitar una recarga. Claude Code vigila las carpetas de skills en busca de cambios. Si una nueva skill no aparece, la documentación sugiere ejecutar /reload-skills.
El frontmatter roto oculta la descripción. Si el YAML en la parte superior de SKILL.md no se analiza correctamente, la skill se carga de todos modos pero sin campos establecidos. Aún puedes escribir su nombre, pero Claude no puede hacer coincidir tu solicitud con su descripción. Ejecutar Claude Code con --debug muestra el error, y claude plugin validate puede verificar una carpeta de skills.
Demasiadas skills pueden omitir descripciones. Claude Code carga una lista de nombres de skills y descripciones en el contexto. Con muchas skills, omite algunas descripciones para ajustarse a un presupuesto, lo que elimina las palabras clave con las que Claude coincide. Ejecuta /doctor para ver el costo del listado, o configura las skills de baja prioridad para que se listen solo por nombre.
Se rechazan algunos nombres. Una carpeta de skill llamada anthropic-skills, o un nombre de carpeta con caracteres como un espacio de ancho cero o corchetes angulares, no se carga.
Skills que desaparecieron
Si las carpetas de skills que creaste en ~/.claude/skills/ han desaparecido, la documentación apunta a un lugar: "busca en ~/.claude/skills/.trash/".
Varias cosas mueven las skills allí. Desactivar la sincronización con el ajuste syncClaudeAiSkills mueve las skills sincronizadas a la carpeta de basura. Si tu organización desactiva las Skills en claude.ai, Claude Code elimina las skills descargadas, y la documentación dice que se mueven a la misma carpeta. Antes de la versión 2.1.280, un archivo llamado manifest.json en tu carpeta de skills también podía mover las skills allí.
Puedes restaurar una skill moviendo su carpeta de vuelta, antes de que la limpieza de retención elimine las entradas de la basura.
Cubrimos dónde aparecen ahora las skills en la aplicación Claude, después de que el menú Customize se convirtiera en Plugins, en nuestra guía sobre Claude plugins y skills.
Lo que la gente intenta primero
Iniciar sesión a mitad de una sesión. Reinicia Claude Code para comenzar la sincronización.
Usar una clave API y esperar sincronización. La sincronización necesita un inicio de sesión con /login.
Escribir el nombre corto. Un comando local puede ser el propietario. Prueba el nombre completo anthropic-skills:.
Editar la copia sincronizada. Cambia la skill en claude.ai en su lugar.
Esperar que Cowork vea las skills locales. Carga tus skills de claude.ai.
La solución: Mantener una sola fuente para cada skill
Paso 1: Ejecuta /skills
Verifica qué skills se cargaron y cuáles se sincronizaron desde claude.ai.
Paso 2: Verifica cómo iniciaste sesión
Usa un inicio de sesión de claude.ai con /login si quieres skills sincronizadas.
Paso 3: Resuelve conflictos de nombres
Renombra la skill local o usa el nombre completo de la skill sincronizada.
Paso 4: Anota dónde reside la fuente de cada skill
Ten en cuenta qué skills se mantienen en claude.ai y cuáles en carpetas locales.
Configurando esto en MemoryLake
Las skills se sincronizan en una dirección, se cargan en algunas sesiones y no en otras, y pueden existir como varias copias con nombres similares. Saber qué copia es la real y por qué se escribió la skill de esa manera es un contexto que los archivos de la skill no contienen.
MemoryLake es una capa de memoria para ese tipo de contexto de trabajo, como convenciones, decisiones de flujo de trabajo y las razones detrás de tus skills, mantenidas en un solo lugar que tú controlas y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de, ni se escribe en, ni se elimina de tus skills de claude.ai, tu carpeta ~/.claude/skills, tus skills sincronizadas, tus archivos de configuración o el almacén de cualquier proveedor. La sincronización de skills funciona de la manera que Anthropic describe.
Paso 1: Crea una clave API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: dónde se mantiene cada skill y por qué existe. Una skill por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code, Codex y los otros asistentes que utilices. Cada uno puede recurrir a las mismas notas sobre tus skills.

Qué cambia esto en la práctica
La primera diferencia es menos ediciones perdidas. Sabes qué copia cambiar.
La segunda es una resolución de problemas más rápida. Cuando falta una skill, sabes de dónde debería venir.
La tercera es la consistencia entre herramientas. Las mismas razones detrás de tus skills están disponibles en Claude Code y en otros lugares.
Mejores prácticas para Claude skills en Claude Code
Edita las skills sincronizadas en claude.ai. Las ediciones locales se sobrescriben.
Evita conflictos de nombres. Un comando local toma el nombre corto.
Inicia sesión con /login para la sincronización. Las sesiones con clave API no se sincronizan.
Habilita las skills en claude.ai para Cowork y la nube. No leen carpetas locales.
Mantén el frontmatter válido. El YAML roto oculta la descripción.
Revisa la carpeta de basura antes de reconstruir. Las skills eliminadas van allí primero.
Conclusión
Claude Code sincroniza las skills habilitadas para tu cuenta de claude.ai en ~/.claude/skills/synced/, pero solo en sesiones que hayan iniciado sesión con una cuenta de claude.ai que obtengan feature flags. Las sesiones con clave API, Bedrock, el modo bare, el modo safe y algunas configuraciones gestionadas detienen la sincronización, y si inicias sesión a mitad de camino, se necesita un reinicio. Las skills sincronizadas anteriormente permanecen en el disco.
Una skill sincronizada cede su nombre corto a cualquier otro comando con el mismo nombre, por lo que aún puede estar allí bajo /anthropic-skills:. Las ediciones en la carpeta sincronizada no se suben y pueden sobrescribirse, así que cambia las skills en claude.ai. Las sesiones de Cowork y en la nube no leen tu carpeta de skills local, y el primer lugar donde buscar una skill que desapareció es ~/.claude/skills/.trash/.