Una skill de Codex para crear y mantener `docs/CONTEXT.md`: el lugar donde viven reglas de dominio, decisiones, límites, relaciones entre proyectos y detalles operativos que no se deducen leyendo el código.
Cómo se usa
Llámala desde la raíz de tu proyecto, da igual si aún no está iniciado o si ya tienes un `docs/CONTEXT.md` antiguo que quieres actualizar. Si además quieres añadir proyectos al ecosistema, basta con mencionarlos y pasarle la ruta o URL completa de cada uno.
Capacidades
Convierte conocimiento implícito en información accionable: por qué existe el proyecto, qué no debe asumir una IA, cómo se relaciona con otros repos y qué fallos no conviene repetir.
Documenta intención de producto, reglas de dominio, límites del proyecto y decisiones que no se ven leyendo solo los ficheros.
Mapea cómo encajan los proyectos relacionados para que el trabajo en un repo se entienda dentro del sistema completo.
Conecta arreglos, decisiones e hitos con una historia fechada que las próximas sesiones pueden revisar rápido.
Distingue conocimiento confirmado de interpretación prudente para que los agentes sepan cuándo actuar y cuándo verificar.
Añade una referencia breve en AGENTS.md para que futuras sesiones sepan leer y mantener el contexto desde el inicio.
Convierte hechos dispersos del proyecto en una guía con estructura, comandos, validación y rutas de trabajo comunes.
Ciclo de vida
La skill cubre la primera creación, migraciones de plantilla y mantenimiento continuo de la documentación.
Genera un primer docs/CONTEXT.md desde evidencia real del repositorio y una estructura v5 completa.
Actualiza CONTEXT.md antiguos sin aplastar notas útiles curadas manualmente.
Alinea contexto, changelog e instrucciones de agentes después de cambios importantes.
Instalación
Usa el CLI abierto de agent skills y elige el agente y el scope durante la instalación. Para Codex, abre una nueva conversación después de instalar.
Abre el instalador interactivo desde el repo open source.
npx skills add paradox-solutions/create-context-skillActualiza la instalación global cuando publiques cambios en el repo.
npx skills update create-context -gEvolución
La plantilla ha ido endureciendo cómo captura contexto: menos texto genérico, más evidencia útil y mejor continuidad entre sesiones.
Reorienta el documento hacia decisiones accionables y conocimiento de negocio que no aparece en el código.
Hace que el contexto sea más visible para cualquier IA que entre al repositorio.
Añade soporte para entender relaciones entre repositorios y evitar cambios aislados.
Separa el histórico detallado del resumen de contexto para que ambos sean útiles.
Un proyecto open source de Paradox Solutions.
paradox-solutions/create-context-skill