Skip to content

Esta página se tradujo del original en coreano con IA y puede contener errores.

Capítulo 5. Trasladar los skills — un resumen semanal con una sola línea, $weekly-review ​

En una línea: los skills de Codex tienen el mismo formato (SKILL.md) que los de Claude Code; solo cambian el lugar donde se guardan y el símbolo para llamarlos. La carpeta es .agents/skills y para llamarlos se usa $nombre. Trasladamos los 3 skills de Herramienta de orden (정리도구), creamos un resumen semanal con una sola línea, $weekly-review, y lo comparamos con el original.

Este capítulo se escribió con la documentación oficial de Codex consultada el 1 de noviembre de 2026 y con la práctica de esta guía (ejecutada en el terminal de Codex). Qué es un skill y para qué se usa se explicó en el capítulo 7 de Claude Code.

El mismo formato, otro lugar ​

Los skills de Codex también son una carpeta que contiene un archivo SKILL.md, y en SKILL.md tienen que figurar sí o sí el nombre (name) y la descripción (description).[1] Los skills siguen un estándar abierto que usan varias herramientas.[2] Por eso trasladamos tal cual, sin modificarlo, el SKILL.md creado en Claude Code.

Lo que cambia es dónde se guarda y cómo se llama.

Claude CodeCodex
Solo para esta carpeta.claude/skills/.agents/skills/
Para todas mis carpetas~/.claude/skills/~/.agents/skills/
Llamarlo/nombre$nombre

Fuente: documentación oficial de Codex[3][4]

Antes de trasladar, lo probé. Dejándolo en .claude/skills y llamando a $weekly-review, Codex no lo encontró enseguida en la lista de skills, sino que lo halló buscando archivos hasta dar con SKILL.md. Esta vez lo encontró, pero es más seguro guardarlo en el lugar establecido.

Comprueba lo aprendido

En Codex, ¿dónde se ponen las skills exclusivas de la carpeta «Herramienta de orden» y cómo se llaman?

Trasladar los skills ​

Le pedí esto a Codex.

Copia los 3 skills de la carpeta .claude/skills a .agents/skills, que es el lugar donde Codex los lee. Deja la carpeta original como está.

Se bloqueó. Fue por la carpeta protegida que viste en el capítulo 4. Dentro de la carpeta de trabajo, .agents es por defecto de solo lectura.[5] Codex avisó de que la copia estaba bloqueada y, en su lugar, me dijo los comandos que debía escribir yo.

bash
mkdir -p .agents/skills
cp -R .claude/skills/meeting-notes .claude/skills/study-notes .claude/skills/weekly-review .agents/skills/

Esta práctica se ejecutó desde el terminal con la forma de permisos fijada de antemano (capítulo 7), así que no pudo preguntar y se detuvo ahí. No pudimos comprobar en esta guía cómo se ve este punto en la aplicación. Si sale una pantalla que pide permiso, lee qué se va a escribir y dónde y decide.

Esta guía ejecutó ella misma el comando que indicó Codex para hacer la copia. Abre el terminal de macOS, entra en la carpeta con cd ~/hello-ai-연습/정리도구 y escribe las dos líneas de arriba. Si es la primera vez que usas el terminal, mira antes el capítulo 10 de Claude Code.

Después de trasladar, basta con que haya tres carpetas bajo .agents/skills: meeting-notes, study-notes y weekly-review.

Comprueba lo aprendido

Le pediste a Codex que copiara una skill a .agents/skills y respondió que “está bloqueado por ser solo de lectura”. ¿Cuál es la reacción adecuada?

Llamarlos con $ ​

Si escribes $ en el cuadro de entrada, puedes elegir un skill y llamarlo.[6] Esta vez envié solo el nombre del skill.

$weekly-review

Una vez terminada la copia, abrió directamente .agents/skills/weekly-review/SKILL.md sin buscar archivos. Y reunió las 3 notas de repaso para crear el resumen semanal.

Resultado: resumen semanal creado con el skill

Comparé los números y los hechos con las notas originales.

Nota originalResumen semanal¿Coincide?
12 «me gusta»12Coincide
Escribió mal el precio: 6000 wonesError de 6000 wonesCoincide
4 sets hoy4Coincide
Total de sets de esta semana: 1111Coincide
Publicó las 3 veces en Instagram3 vecesCoincide
Coste del vino caliente especiado (뱅쇼): 1800 wonesNo apareceFalta
Compró una bombilla y la cambióNo apareceFalta
2 horas escribiendo el textoNo apareceFalta

Fuente: resultado de la práctica de esta guía (2026-11-01)

No había ningún punto erróneo, pero faltaban tres cosas. Parece que se dejaron fuera porque no encajaban justo en las tres casillas del formato del repaso (lo que salió bien, lo que fue una pena y lo que hacer la semana que viene). Así que comprueba no solo lo que está mal, sino también lo que falta. Si hay contenido que no debe faltar, basta con añadir al skill una línea como: «Los números que pueden ser tema de la próxima reunión, como el del vino caliente especiado, se ponen en lo que hay que hacer la semana que viene».

Aunque no lo llames, si la petición coincide con la descripción de un skill, Codex puede elegirlo por su cuenta.[7] Por eso conviene dejar bien claro cuándo se usa al principio de la descripción.[8]

Comprueba lo aprendido

En la revisión semanal creada con $weekly-review estaban bien todas las cifras, pero faltaba el coste de 1.800 wones del vino caliente. ¿Qué siguiente paso recomienda esta guía?

Crear un skill nuevo y los plugins ​

Para crear un skill nuevo desde cero, llamas a $skill-creator, que viene incluido de serie, y explicas el objetivo, los pasos y el formato.[9] Según la documentación oficial, un buen primer skill es un trabajo cuyos pasos y formato son siempre los mismos, como un informe semanal o el seguimiento de una reunión.[10] Los tres skills de Herramienta de orden son justo ese tipo de ejemplo.

Un plugin es un paquete que se instala y que junta skills y conexiones con herramientas externas.[11] ChatGPT y Codex comparten una sola lista de plugins.[12] Sobre los hooks (scripts que se ejecutan automáticamente) que lleva un plugin, dice que los revises antes de que se ejecuten y juzgues si son de fiar.[13] Con un plugin que veas por primera vez, comprueba antes quién lo hizo y qué permisos tiene, como aprendiste en el capítulo 7 de Claude Code.

Comprueba lo aprendido

Vas a instalar un plugin que no conoces. ¿Qué destaca la documentación oficial?

Pruébalo tú ​

  1. Pídele a Codex que copie los 3 skills de .claude/skills a .agents/skills. Si pide permiso, lee el contenido y decide; si se bloquea, escribe tú mismo en el terminal (también sirve «View → Open Terminal» del menú de la aplicación) los dos comandos del texto.
  2. Abre una conversación nueva y escribe $ en el cuadro de entrada para comprobar que se ven los tres skills.
  3. Envía $weekly-review y compara el resultado con las notas originales. Cuenta por separado lo que está mal y lo que falta.
  4. Si falta algo, añade una línea al skill y vuelve a ejecutarlo.

Proyecto continuo: en el capítulo 6 veremos una programación que ejecuta sola el resumen semanal todos los viernes, y la nube y el teléfono.

Resumen ​

  • El formato del skill (SKILL.md) es el mismo que en Claude Code. Se guarda en .agents/skills y se llama con $nombre.
  • .agents es una carpeta protegida, así que al trasladar puede bloquearse o pedir permiso (esta guía solo comprobó el bloqueo en el terminal).
  • Con una sola línea, $weekly-review, salió el resumen semanal. Acertó 5 puntos y faltaron 3.
  • Comprueba no solo lo que está mal, sino también lo que falta. Si se repite, corrige el skill.

Glosario ​

TérminoEn españolEn una línea
Mención con $Mención con dólarForma de llamar a un skill por su nombre en Codex
.agents/skills.agents/skillsEl lugar donde Codex busca los skills de esta carpeta
skill-creatorskill-creatorSkill incluido de serie que ayuda a crear skills nuevos

¿Terminaste este capítulo?

El progreso se guarda solo en este navegador. Puedes ver tu avance en el índice completo.

Siguiente capítulo: Capítulo 6. Programación, nube y teléfono

Referencias (13)
  1. Documentación oficial de Codex, «Build skills». "A skill is a directory with a SKILL.md file plus optional scripts and references. The SKILL.md file must include name and description." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  2. Documentación oficial de Codex, «Build skills». "Skills build on the open agent skills standard." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  3. Documentación oficial de Codex, «Build skills». "For repositories, Codex scans .agents/skills in every directory from your current working directory up to the repository root." / "$HOME/.agents/skills
    Any skills checked into the user's personal folder." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  4. Documentación oficial de Codex, «Skills & Plugins». "ChatGPT supports @ mentions, while Codex supports $ mentions for skills." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  5. Documentación oficial de Codex, «Agent approvals & security». "<writable_root>/.agents is protected as read-only when it exists as a directory." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  6. Documentación oficial de Codex, «Slash commands». "You can also explicitly invoke skills by typing $ in the chat composer." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  7. Documentación oficial de Codex, «Build skills». "Implicit invocation: ChatGPT or Codex can choose a skill when your task matches the skill description." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  8. Documentación oficial de Codex, «Build skills». "Front-load the key use case and trigger words so a host can still match the skill if descriptions are shortened." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  9. Documentación oficial de Codex, «Skills & Plugins». "In ChatGPT, start with @skill-creator; in Codex, use $skill-creator." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  10. Documentación oficial de Codex, «Skills & Plugins». "Good first skills include a weekly update, a campaign brief, a meeting follow-up, or any task where the steps and format should stay consistent." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  11. Documentación oficial de Codex, «Skills & Plugins». "A plugin is an installable bundle that can include skills and Model Context Protocol (MCP) servers." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  12. Documentación oficial de Codex, «Skills & Plugins». "ChatGPT and Codex share one universal plugin directory." learn.chatgpt.com (consultado el 2026-11-01) ↩︎

  13. Documentación oficial de Codex, «Plugins». "Review and trust plugin hooks before they run." learn.chatgpt.com (consultado el 2026-11-01) ↩︎