How do I install the Gen Release Notes skill?

Run npx skillmds@latest add atournayre/gen-release-notes in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gen Release Notes safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gen Release Notes?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gen Release Notes free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gen Release Notes?

atournayre (@atournayre) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gen Release Notes by atournayre — Agent Skill

Name: Gen Release Notes
Rating: 4.5 (4 reviews)
Author: atournayre

File contents

Gen Release Notes Skill

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Usage

/git:gen-release-notes <branche-source> <branche-cible> [nom-release]

Si arguments manquants : AskUserQuestion pour demander.

Workflow

Initialisation

Créer les tâches du workflow :

Utiliser TaskCreate pour chaque étape :

TaskCreate #1: Parser et valider arguments (branches source/cible)
TaskCreate #2: Collecter commits via git log
TaskCreate #3: Catégoriser par impact utilisateur
TaskCreate #4: Rédiger descriptions sans jargon
TaskCreate #5: Générer HTML dans .claude/reports/

Important :

Utiliser activeForm (ex: "Validant les arguments", "Collectant les commits")
Chaque tâche doit être marquée in_progress puis completed

Pattern d'exécution pour chaque étape :

TaskUpdate → tâche en in_progress
Exécuter l'étape
TaskUpdate → tâche en completed

Étapes

Parser et valider arguments (branches source/cible)
Collecter commits via git log
Catégoriser par impact utilisateur
Rédiger descriptions sans jargon
Générer HTML dans .claude/reports/

Catégories

Catégorie	Icône	Mots-clés
Nouveautés	⭐	feat, ✨, 🚀
Améliorations	📈	improve, ⚡, perf
Corrections	✅	fix, 🐛
Sécurité	🔒	security

Commits ignorés

refactor:, test:, chore:, ci:, docs:, style:
Commits de merge
Mises à jour de dépendances

Règles de rédaction

ZÉRO jargon - Pas de API, SQL, cache, endpoint, refactoring
Bénéfice utilisateur - "L'application est plus rapide" vs "Optimisation SQL"
Verbes d'action - Vous pouvez maintenant..., Nous avons corrigé...
Phrases courtes - Max 1-2 phrases par item

Exemples

Commit	Note utilisateur
`feat: implémenter cache Redis`	L'affichage est plus rapide
`fix: corriger validation email`	Certaines adresses email sont maintenant acceptées

Output

{REPORT_PATH}/release_notes_{RELEASE_NAME}.html

Task Management

Progression du workflow :

5 tâches créées à l'initialisation
Chaque étape suit le pattern : in_progress → exécution → completed
Utiliser TaskList pour voir la progression
Les tâches permettent à l'utilisateur de suivre la génération des release notes

References

Template HTML - Structure et CSS du fichier généré
Règles de rédaction - Exemples de transformation et conventions

---name: gen-release-notesdescription: Génère des notes de release HTML orientées utilisateurs finaux. Transforme les commits techniques en descriptions accessibles sans jargon.---# Gen Release Notes Skill## Instructions à Exécuter**IMPORTANT : Exécute ce workflow étape par étape :**## Usage```/git:gen-release-notes <branche-source> <branche-cible> [nom-release]```Si arguments manquants : `AskUserQuestion` pour demander.## Workflow### Initialisation**Créer les tâches du workflow :**Utiliser `TaskCreate` pour chaque étape :```TaskCreate #1: Parser et valider arguments (branches source/cible)TaskCreate #2: Collecter commits via git logTaskCreate #3: Catégoriser par impact utilisateurTaskCreate #4: Rédiger descriptions sans jargonTaskCreate #5: Générer HTML dans .claude/reports/```**Important :**- Utiliser `activeForm` (ex: "Validant les arguments", "Collectant les commits")- Chaque tâche doit être marquée `in_progress` puis `completed`**Pattern d'exécution pour chaque étape :**1. `TaskUpdate` → tâche en `in_progress`2. Exécuter l'étape3. `TaskUpdate` → tâche en `completed`### Étapes1. Parser et valider arguments (branches source/cible)2. Collecter commits via `git log`3. Catégoriser par impact utilisateur4. Rédiger descriptions sans jargon5. Générer HTML dans `.claude/reports/`## Catégories| Catégorie | Icône | Mots-clés ||-----------|-------|-----------|| Nouveautés | ⭐ | feat, ✨, 🚀 || Améliorations | 📈 | improve, ⚡, perf || Corrections | ✅ | fix, 🐛 || Sécurité | 🔒 | security |## Commits ignorés- `refactor:`, `test:`, `chore:`, `ci:`, `docs:`, `style:`- Commits de merge- Mises à jour de dépendances## Règles de rédaction1. **ZÉRO jargon** - Pas de API, SQL, cache, endpoint, refactoring2. **Bénéfice utilisateur** - "L'application est plus rapide" vs "Optimisation SQL"3. **Verbes d'action** - Vous pouvez maintenant..., Nous avons corrigé...4. **Phrases courtes** - Max 1-2 phrases par item## Exemples| Commit | Note utilisateur ||--------|------------------|| `feat: implémenter cache Redis` | L'affichage est plus rapide || `fix: corriger validation email` | Certaines adresses email sont maintenant acceptées |## Output`{REPORT_PATH}/release_notes_{RELEASE_NAME}.html`## Task Management**Progression du workflow :**- 5 tâches créées à l'initialisation- Chaque étape suit le pattern : `in_progress` → exécution → `completed`- Utiliser `TaskList` pour voir la progression- Les tâches permettent à l'utilisateur de suivre la génération des release notes## References- [Template HTML](references/html-template.html) - Structure et CSS du fichier généré- [Règles de rédaction](references/writing-rules.md) - Exemples de transformation et conventions

Frequently asked questions

Gen Release Notes