En Claude Code, copia la carpeta y conserva el nombre
Coloca el directorio en ~/.claude/skills/ o en el .claude/skills/ del proyecto, de modo que el nombre de la carpeta siga coincidiendo con el campo name dentro de SKILL.md. Elige la ubicación del proyecto si la skill codifica reglas de un código concreto, o la personal si codifica tu forma de trabajar. Una skill instalada en el alcance equivocado no está rota: simplemente está presente en sesiones donde nadie la quería.
En claude.ai y en la API, se sube
claude.ai recibe la carpeta de la skill como archivo ZIP desde su configuración de skills, y necesita la ejecución de código activada, porque ahí es donde corren las skills. La API de Claude recibe la skill por los endpoints /v1/skills; después cada petición nombra su skill_id en el parámetro container junto a la herramienta de ejecución de código, y la skill queda disponible para todo el workspace. Las copias no se sincronizan, así que un cambio hecho en una superficie hay que volver a subirlo en las otras.
Lee la skill antes de instalarla
Una skill son instrucciones que un agente va a seguir, y puede traer scripts que tenga permiso de ejecutar. Instalar una que no has leído se parece más a ejecutar un script ajeno que a instalar un tema visual. Revisa qué le dice al agente, revisa qué hay bajo scripts/ y prefiere skills cuyo origen puedas ver.
Confirma que cargó, no solo que se copió
El fallo que la gente reporta como problema de instalación casi siempre es un nombre que no coincide con el directorio, o una descripción demasiado vaga para coincidir con ninguna tarea. Pide al agente exactamente aquello para lo que existe la skill y observa si cambia su comportamiento. Si no cambia nada, el problema es la descripción, no la ubicación del archivo.