Skip to content
Back to skills

Redacteur

ASecurity

Le rédacteur : rédiger un document du dépôt lu par des humains. À charger avant d'écrire ou de réécrire : l'architecture du projet ou d'un composant, son cadre, son interface ; une spécification ; un guide ; tout document de référence. Pour un document lu par un agent (compétence, charte, consigne), `grillhouse:writing-for-agents`.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgit

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned November 18, 2026

npx -y skills add roomi-fields/roomis-grillhouse --skill redacteur --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Redacteur?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Redacteur
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/roomi-fields-redacteur/badge)](https://www.skillsdirectory.com/skills/roomi-fields-redacteur)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: redacteur
description: >
  Le rédacteur : rédiger un document du dépôt lu par des humains. À charger avant d'écrire ou de réécrire :
  l'architecture du projet ou d'un composant, son cadre, son interface ; une spécification ; un
  guide ; tout document de référence. Pour un document lu par un agent (compétence, charte,
  consigne), `grillhouse:writing-for-agents`.
---

# Rédacteur — rédiger un document

Chaque document a un public, un modèle que ce public connaît déjà, et un squelette de section.
Les règles ci-dessous valent pour tous ; la référence du type donne le reste.

## Ce qui vaut pour tout document

Le lecteur est un ingénieur. Chaque phrase lui apprend ce qu'est une chose ou ce qu'elle fait, avec
les mots qu'il emploie lui-même. La langue du document est celle de la charte.

### Le fond

- **Une phrase dit ce qui est** : elle décrit ce qu'une chose est ou fait ; une limite s'énonce par
  ce que fait l'autre composant. Ainsi le document se lit comme l'architecture que le code suit.
- **Le principe avant le nom** : le lecteur apprend à quoi sert une chose avant d'en lire le nom.
  Une notion se définit une fois, juste avant son premier usage. Ainsi chaque nom du document
  désigne une chose comprise.
- **Une information, une adresse** : elle vit à une seule place, dans le document et entre les
  documents ; ce qu'un autre document dit se cite par un renvoi, en fin de section. Ainsi chaque
  décision de l'architecture a une seule version, celle que le code suit.
- **Deux choses parallèles se décrivent de la même manière** : si les entrées passent par un bus,
  les sorties aussi, ou aucune des deux n'en parle. Ainsi le lecteur compare ce qui se compare.
- **Le document parle de son sujet** : une architecture décrit le produit ; l'organisation du
  dépôt et la façon de travailler vivent dans la charte. Ainsi chaque document répond à une seule
  question.
- **Une règle s'écrit selon le métacadre** (`${CLAUDE_PLUGIN_ROOT}/METACADRE.md`, §2) : elle sert une intention du cadre
  et la nomme.

### La phrase

- **Le vocabulaire de la programmation** : on emploie le mot technique exact (une fonction reçoit
  et retourne, un paquet dépend d'un autre). Ainsi chaque phrase dit une seule chose, celle que le
  code fait.
- **Le sujet et le verbe précis** : la phrase nomme ce qui agit et l'opération exacte. Ainsi le
  lecteur sait quel composant fait quoi.
- **Le ton d'un ingénieur** : des phrases simples et neutres, une affirmation par phrase, comme
  dans une spécification. Ainsi le document est celui d'un produit professionnel.
- **Le gras marque un terme défini** ou une entrée de liste. Ainsi il guide la lecture au lieu
  d'insister.
- **Les identifiants en police de code** : un identifiant du code s'écrit en police de code. Ainsi
  le lecteur distingue le code de la prose.
- **Un composant se nomme par son nom.** Ainsi le lecteur sait toujours de quel composant on
  parle.

### La forme

- **L'introduction dit ce qu'est la chose et ce qu'elle fait.** Ainsi le lecteur sait dès la
  première phrase de quoi parle le document.
- **Les titres numérotés** : chaque titre porte son numéro (`## 1.`, `### 1.2`). Ainsi un ticket
  cite une section par son adresse.
- **Tout exemple est exécuté** : un test exécute chaque exemple du document, accepté, refusé ou
  joué ; le document cite l'exemple, le test vit à part. Ainsi chaque exemple est prouvé.

### Le circuit

- **Les documents du responsable** : le texte nouveau d'un document que la charte lui réserve
  s'écrit d'abord dans le ticket, et entre au document après son accord. Ainsi le responsable
  tranche ce qui décide de l'architecture.
- **Déplacer, puis réécrire** : un texte se déplace tel quel dans un commit ; sa réécriture vient
  dans le suivant. Ainsi chaque changement de fond se lit et se vérifie seul.
- **Un paragraphe sur une seule ligne** : un paragraphe, une entrée de liste ou une cellule
  s'écrit sans retour à la ligne ; l'éditeur replie le texte. Ainsi un diff montre la phrase
  changée, et non le paragraphe recoupé.

## Le type du document

Lis la référence du type avant d'écrire la première section :

- [Les documents d'un composant](references/documents-d-un-composant.md) — pour l'architecture du
  projet ou d'un composant (sa construction), son cadre (son rôle et sa frontière) ou son interface.

Un projet ajoute ses propres types sous `docs/agents/redacteur/`, un fichier par type, sur le même
modèle (lecteur, modèle, squelette, critère de fin) : lis celui du document que tu écris.

Une section est finie quand elle remplit le critère de fin de sa référence, point par point.

Files in this skill

  • SKILL.md4.6 KB
  • references/documents-d-un-composant.md9 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.