🌐 Subagentes en Codex y otros entornos

Piensa en una toma de corriente. El aparato es el mismo; cambia el adaptador según el país. El principio (110/220 V, un enchufe) no cambia — cambia el encaje. Un subagente funciona igual: el principio —«delegar en un contexto aislado y recibir un resumen»— es universal. Lo que cambia de un entorno a otro es el encaje: dónde está el archivo, cómo se llama el frontmatter, los nombres de las herramientas. El objetivo de este módulo es escribir un único .md y conectarlo a dos runtimes.

↑ Una fuente .md; cada runtime aplica su adaptador. La idea es la misma; el encaje cambia.

Todo lo que aprendiste hasta aquí — un director que delega, una ventana propia, un informe limpio — describe un estándar, no un producto. El patrón es: "una tarea grande se convierte en un subproceso con contexto propio; solo vuelve la conclusión". Cualquier herramienta seria de agentes necesita algo así, porque el problema (contexto que se llena, trabajo que se repite) es universal. Por eso el concepto es aplicable en otros contextos.

O Codex CLI (el agente de terminal de OpenAI) tiene las mismas piezas, solo que con un vocabulario diferente. Donde Claude Code habla de «subagente» y «skill», Codex habla de prompts e agentes markdown que guardas en una carpeta e invocas. La estructura coincide: un archivo de instrucciones + un activador + un conjunto de herramientas permitidas.

En vez de mantener dos copias (una para Claude y otra para Codex) que divergen con el tiempo, escribes una sola fuente y «emite» la versión de cada runtime a partir de ella. Esa es la idea de un polyskill: uno .md portable es el plantilla, y cada entorno es un build de ese molde. Una verdad, varios destinos — lo opuesto a copiar y pegar.

Las herramientas tienen nombres diferentes, pero las capacidades son las mismas: leer archivos, buscar en texto, listar rutas, editar, ejecutar shell. En lugar de citar el nombre exacto de la herramienta en el cuerpo de tu .md, describe la capacidad ("lee los archivos", "busca por defecto") — así el mismo texto funciona en ambos, porque cada runtime determina qué herramienta concreta usar.

Antes de portar, fija el límite. El principio — delegar a un contexto aislado, un papel por agente, devolver un resumen — atraviesa cualquier entorno intacto. Lo que cambia es la carcasa: nombres de campos, carpetas, sintaxis de invocación, herramientas disponibles. Saber qué se mantiene estable evita reescribir lo que ya estaba bien.

Portar es un procedimiento de tres tiempos: extraer el núcleo, cambiar la carcasa, probar la paridad. Pero la portabilidad tiene un límite: no todo cruza la frontera. Las cosas muy ligadas a un runtime —una MCP exclusiva, un nombre de tool específico, un modelo de un solo proveedor— no se trasladan y se convierten en una nota de adaptación.

Aquí hay un doc-summarizer.md escrito para ser portable: el frontmatter es la carcasa de Claude Code, y el cuerpo es el núcleo agnóstico de herramientas. Justo después, la nota de adaptación muestra qué cambiar para ejecutar el mismo archivo en Codex CLI.

--- # CASCA (Claude Code) — troca por runtime
name: doc-summarizer
description: Lê documentos longos e devolve um resumo
  curto com os pontos-chave. Use para condensar
  arquivos grandes sem encher o contexto.
tools: Read, Grep, Glob   # só leitura
model: haiku             # barato p/ escanear
---

# MIOLO (portável) — NÃO cita ferramenta por nome
You are a precise document summarizer.

When invoked:
1. Read the target documents and grasp the intent.
2. Search for the key claims, numbers and decisions.
3. Write a summary: 5 bullets, then the source paths.

Output: only the summary. Do not paste raw
content. Do not modify any file.

Tres prompts para portar y ejecutar en distintos entornos. El patrón es siempre el mismo: pide que preserve el núcleo, adaptar a carcasa, y dejar una nota dónde termina la portabilidad.

Pegue este subagente do Claude Code e adapte para o
Codex CLI. Mantenha o corpo (papel/passos/saída) intacto,
troque só a casca: pasta, frontmatter e invocação. No fim,
liste uma "nota de adaptação" com o que não é portável.

Reescreva esta skill como fonte portável: remova nomes
de ferramenta específicos do corpo e descreva a capacidade
("leia", "busque"). Depois emita dois builds — um para
Claude Code, um para Codex — a partir da mesma fonte.

Liste as ferramentas que este .md usa no Claude Code
(Read, Grep, Glob, Bash…) e me dê o equivalente de shell
para o Codex. Aponte quais não têm equivalente direto e
precisam virar nota de adaptação.

Así es como aparece en la terminal una compilación entre runtimes: ejecutas el emisor una vez sobre la fuente portátil, y genera los archivos de cada entorno, adaptando la envoltura y conservando el núcleo. Observa los dos destinos que salen del mismo SKILL.md.

↑ Recreación ilustrativa del terminal (no es una captura de pantalla real). Entra una fuente; salen dos builds con el mismo contenido y distintas envolturas.