MemoryLake
Volver a todos los artículos
Tutorial20 de noviembre de 2026·11 min de lectura

¿Por qué no aparecen tus Claude Skills en Claude Code? Cuándo se sincronizan las Skills desde claude.ai, por qué gana una Skill local con el mismo nombre y por qué se sobrescriben las ediciones en la carpeta sincronizada (2026)

Creaste una skill en la aplicación web de Claude para escribir el informe semanal de tu equipo. Allí funciona bien. Abriste Claude Code en tu terminal, escribiste una barra diagonal y el nombre de la skill, y no hubo coincidencias. Otro día apareció, pero bajo un nombre más largo con un prefijo. Cuando corregiste una errata en el archivo de la skill en tu computadora, la corrección había desaparecido a la mañana siguiente.

Estos tres comportamientos provienen de una sola función. La documentación de Claude Code de Anthropic explica que en algunas sesiones, "Claude Code carga las skills habilitadas para tu cuenta de claude.ai, sin configuración por tu parte". También explica los límites: la sincronización solo se ejecuta en ciertas sesiones, cede el paso a otros comandos con el mismo nombre y solo funciona en una dirección. "Claude Code descarga las skills sincronizadas y nunca las sube".

Esta guía cubre dónde busca Claude Code las skills, cuándo se sincronizan las skills de claude.ai, qué sesiones no se sincronizan, por qué gana una skill local con el mismo nombre, por qué las ediciones en la carpeta sincronizada no perduran, por qué algunas skills se cargan tarde o no se cargan en absoluto en ciertas sesiones, y cómo encontrar skills que parecen haber desaparecido.

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.md en un repositorio.
  • Anidado: una carpeta .claude/skills dentro 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.

La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente

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.

El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable
El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable

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.

La pantalla de integraciones de MemoryLake enumerando los clientes de IA y frameworks de agentes que pueden conectarse a la capa de memoria
La pantalla de integraciones de MemoryLake enumerando los clientes de IA y frameworks de agentes que pueden conectarse a la capa de memoria

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/.

Preguntas frecuentes

¿Por qué mis skills de claude.ai no aparecen en Claude Code?

Es posible que la sesión no se sincronice. La sincronización necesita un inicio de sesión en claude.ai con /login y no se ejecuta con una clave API, en Bedrock, ni en modo bare o safe.

¿Dónde guarda Claude Code las skills sincronizadas?

En ~/.claude/skills/synced/.

¿Por qué mi skill solo funciona como /anthropic-skills:nombre?

Otro comando usa el nombre corto. El otro comando se ejecuta para /nombre.

¿Puedo editar una skill sincronizada en Claude Code?

Las ediciones no se guardan en claude.ai y pueden sobrescribirse. Cambia la skill en claude.ai.

¿Las sesiones de Cowork cargan mis skills locales?

No. Las sesiones de Cowork y en la nube cargan las skills habilitadas para tu cuenta de claude.ai.

¿Cómo veo qué skills se sincronizaron?

Ejecuta /skills. Las skills sincronizadas se enumeran bajo claude.ai sync.

¿A dónde fueron mis skills personales?

Revisa ~/.claude/skills/.trash/ y mueve la carpeta de vuelta para restaurarla.