Créer un agent éditorial AI coding avec Codex sans générer du contenu creux

Un agent éditorial ne sert pas à écrire plus vite un texte moyen.

S’il fait juste “rédige-moi un article sur Cursor”, tu vas obtenir exactement ce que tu voulais éviter : une intro molle, trois généralités, une conclusion interchangeable, et des phrases qui sentent la génération.

Le bon usage, c’est de lui donner un rôle plus dur : filtrer les sujets, vérifier les sources, cadrer la tension, puis seulement écrire.

1. Commence par le contrat éditorial

Avant l’agent, écris les règles qui ne bougent pas :

• audience : développeurs seniors, fondateurs techniques, builders;
• ton : direct, concret, sceptique;
• interdits : hype vide, SEO artificiel, “dans cet article”;
• obligation : citer les sources quand le sujet est récent;
• sortie : Markdown compatible avec ta collection Astro.

Dans Codex, ce socle va dans AGENTS.md si la règle concerne tout le repo. Le workflow détaillé va dans une skill.

2. Fais une skill, pas un prompt jetable

Une skill ai-coding-tutorial doit dire quand elle s’active et ce qu’elle produit.

Le contenu minimum :

---
name: ai-coding-tutorial
description: Use when creating /ai-coding tutorials about Codex, Claude Code, Copilot, Cursor, MCP, agents, hooks, context, or AI coding workflows.
---

Ensuite, ajoute le workflow :

1. lire AGENTS.md;
2. inspecter src/content.config.ts;
3. lire un tutoriel existant;
4. vérifier les faits récents;
5. écrire FR + EN;
6. lancer bun run build.

Cette séquence évite deux erreurs classiques : écrire dans la mauvaise collection et oublier la version anglaise.

3. Donne-lui une grille de refus

Un agent éditorial faible accepte tous les sujets. Un bon agent doit pouvoir dire : “pas assez solide”.

Critères utiles :

• le sujet change-t-il vraiment un workflow de dev ?
• la source est-elle officielle ou primaire ?
• le texte peut-il inclure une décision concrète ?
• y a-t-il un coût, un risque, une limite ou une charge de review ?

Si la réponse est non, le sujet reste une brève newsletter, pas un tutoriel.

4. Sépare recherche et rédaction

Pour un sujet récent, demande d’abord :

Utilise la skill ai-coding-tutorial pour proposer 5 angles.
Ne rédige pas encore.
Pour chaque angle, donne la source officielle et le risque de bullshit.

Ensuite seulement :

Rédige l'angle 2 en tutoriel /ai-coding.
Garde un ton terrain, pas marketing.
Ajoute la version anglaise.

Tu gardes le contrôle sur la ligne éditoriale, et l’agent travaille sur un sujet déjà validé.

5. Le format qui marche

Pour /ai-coding, vise un tutoriel de terrain :

• tension concrète en ouverture;
• contexte court;
• grille de décision;
• workflow étape par étape;
• pièges à éviter;
• sources.

Le lecteur doit repartir avec une manière de travailler, pas seulement une opinion.

Sources

• OpenAI Codex - Agent Skills
• OpenAI Codex - Custom agents and subagents