Menu
Préférences Markdown de Stéphane Klein. Conventions de formatage pour les listes, les tableaux, la structure et la mise en forme.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Créer un nouveau projet Node.js avec PostgreSQL (raw SQL, migrations, conteneur Podman) basé sur les préférences de Stéphane Klein. Use when user wants to create a Node.js project with PostgreSQL, migrations, or raw SQL.
Initialize ADR/agents/docs infrastructure in a project
Génère le template (template/), le script generate.sh, le vars-example.yaml, et le SKILL.md d'un projet à partir d'un projet source existant. Use when user wants to create a project scaffolding template from an existing project.
Conventions HTTP API de Stéphane Klein — nommage, verbes, codes, pagination, erreurs, versioning, HATEOAS, filtres, embedding, upload, OpenAPI. Utiliser lors de la création, modification ou review d'une API HTTP.
Gère la todo list de Stéphane via la banque mémoire hindsight `todo` et le sous-agent `@todo`. Use when user says: ajoute à ma todo, marque comme fait, liste mes tâches, supprime une tâche, bloque/débloque une tâche, quelles sont mes priorités, importe ça dans ma todo, ou colle un bloc de texte contenant plusieurs tâches.
Guide pour la création de nouveaux skills
| name | sklein-markdown |
| description | Préférences Markdown de Stéphane Klein. Conventions de formatage pour les listes, les tableaux, la structure et la mise en forme. |
Conventions de formatage Markdown pour toute rédaction.
- pour les listes à puces (pas *).**gras** pour l'emphase (pas __gras__ ni *italique* pour l'emphase principale).Format préféré : une ligne vide sépare le paragraphe introductif de la liste, mais pas de ligne vide au sein de la liste.
Paragraphe:
- item 1
- item 2
- item 2.1
- item 2.2
- item 3
Format à éviter : pas de ligne vide entre le paragraphe et la liste, ni de ligne vide au milieu de la liste.
Paragraphe:
- item 1
- item 2
- item 2.1
- item 2.2
- item 3
:.:---, centrer :---:, aligner à droite ---:.Exemple :
| Colonne 1 | Colonne 2 | Colonne 3 |
|:----------|:---------:|----------:|
| Gauche | Centré | Droite |
$ indiquent une commande utilisateur.# indiquent une commande root.# ….$ echo "Hello, world!"
Hello, world!
$ sudo su
# systemctl restart nginx
$ exit
$ uptime # Affiche l'uptime
$ (y compris sans sortie)Contrairement à la règle MD014 (omettre $ quand il n'y a pas de sortie), toujours préfixer les commandes par $, même si le bloc ne contient que des commandes sans sortie.
Justification : dans une documentation qui mélange fichiers de configuration et commandes, l'absence de $ crée une ambiguïté entre ce qui est à exécuter et ce qui est de la configuration.
Ils n'ont pas vocation à être copiés/collés en masse. Si un groupe de commandes est fréquemment copié, le remplacer par un script helper (voir sklein-helper-scripts).
Quand un README liste les dossiers d'un projet, chaque entrée doit être un lien cliquable vers le dossier concerné :
- [`01-fedora-minimal-mutable/`](./01-fedora-minimal-mutable/) — Description.
- [`02-fedora-minimal-bootc/`](./02-fedora-minimal-bootc/) — Description.
Format : [`nom-dossier/`](./nom-dossier/) — backticks + slash + lien relatif.
Ces conventions s'appliquent à tout Markdown, sauf si le projet concerné définit déjà ses propres conventions de formatage.