Qué es Claude Skills: una biblioteca de instrucciones y herramientas
Arquitectura de Claude Skills: carpetas reales, espejos y adaptadores
Sigue una skill desde la carpeta de autor hasta el cliente que la consume
Qué aprenderás
- Ubica la fuente
- Sigue los metadatos
- Mantén visible la frontera
Antes de empezar
- Un proyecto desechable
- Una revisión fijada del repositorio
- Un cliente de agente compatible
Convierte una entrada de catálogo en una decisión medible y reversible
Conclusiones clave
- El espejo distribuye; no es la carpeta de autor.
- Metadatos e instalador tienen funciones distintas.
- Los permisos del agente siguen contando.
Ubica la fuente
Los directorios por dominio contienen el SKILL.md escrito por el autor y, cuando corresponde, scripts y referencias. La skill agent-harness ejemplifica un contrato de trabajo, no un servicio permanente.
El repositorio también ofrece metadatos de plugins y árboles espejo para agentes. En Windows esos espejos pueden depender de enlaces simbólicos; comprueba el archivo copiado, no solo el número de carpetas.
Sigue los metadatos
El JSON del marketplace de Claude agrupa plugins y apunta a carpetas fuente. Codex usa un índice y un árbol espejo; el instalador selecciona entradas, sigue enlaces y copia paquetes.
Los scripts de conversión producen reglas en formatos ajenos. Conservar palabras no garantiza el mismo disparador ni los mismos permisos, así que el adaptador generado debe probarse.
Mantén visible la frontera
SKILL.md se convierte en entrada para un agente; las herramientas incluidas pueden ejecutarse como código. Un listado del marketplace no crea un sandbox. Los permisos del cliente y la aprobación humana siguen siendo externos.
Este mapa procede de fuentes fijadas y no afirma que todos los clientes carguen igual. Sigue una skill completa en un cliente antes de ampliar el diseño.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Localiza una carpeta fuente real.
- 2
Traza el índice o marketplace hasta el destino.
- 3
Comprueba activación y scripts en un cliente.
Ejemplo para copiar
carpeta real -> marketplace
carpeta real -> espejo/índice -> copia Codex
carpeta real -> conversión -> regla del clientePreguntas frecuentes
¿Basta con SKILL.md para copiar una skill?
No siempre: puede depender de scripts, plantillas y referencias.
¿La conversión asegura paridad entre Cursor y Codex?
No; el formato no demuestra activación ni permisos equivalentes.
Fuentes
- Claude Skills / README.mdFuente verificada 2026-10-04
- Claude Skills / .claude-plugin/marketplace.jsonFuente verificada 2026-10-04
- Claude Skills / scripts/codex-install.shFuente verificada 2026-10-04
- Claude Skills / scripts/convert.shFuente verificada 2026-10-04
- Claude Skills / scripts/install.shFuente verificada 2026-10-04
- Claude Skills / engineering/agent-harness/skills/agent-harness/SKILL.mdFuente verificada 2026-10-04