marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(skills): publish 5 new skills to SkillHub

Browse source 
Add skill-creator, landing-page-generator, ccboard, guide-recap,
and release-notes-generator with genericized content (no personal
refs, FR→EN translation, placeholder URLs/paths).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-02-15 21:10:09 +01:00
parent 9e738f0a87
commit 52d76411e3
15 changed files with 239 additions and 240 deletions
Download patch file Download diff file Expand all files Collapse all files

5
examples/skills/ccboard/.claude-plugin/plugin.json
View file

@ -2,9 +2,8 @@
"name": "ccboard",
"version": "0.1.0",
"description": "Comprehensive TUI/Web dashboard for Claude Code monitoring and management",
"author": "Florian Bruniaux",
"homepage": "https://github.com/FlorianBruniaux/ccboard",
"repository": "https://github.com/FlorianBruniaux/ccboard",
"homepage": "https://github.com/{OWNER}/ccboard",
"repository": "https://github.com/{OWNER}/ccboard",
"license": "MIT OR Apache-2.0",
"requires": {
"binary": "ccboard",

4
examples/skills/ccboard/README.md
View file

@ -172,8 +172,8 @@ cat ~/.claude/stats-cache.json # Check stats file
## Links
- **Repository**: https://github.com/FlorianBruniaux/ccboard
- **Issues**: https://github.com/FlorianBruniaux/ccboard/issues
- **Repository**: https://github.com/{OWNER}/ccboard
- **Issues**: https://github.com/{OWNER}/ccboard/issues
- **Claude Code**: https://claude.ai/code
## License

28
examples/skills/ccboard/SKILL.md
View file

@ -57,16 +57,16 @@ cargo install ccboard
### 8 Interactive Tabs
#### 1. Dashboard (Press `1`)
- Token usage statistics (17.32M total)
- Session count (1.2K tracked)
- Messages sent (327.7K)
- Cache hit ratio (99.9%)
- MCP server count (3 servers)
- Token usage statistics
- Session count
- Messages sent
- Cache hit ratio
- MCP server count
- 7-day activity sparkline
- Top 5 models usage gauges
#### 2. Sessions (Press `2`)
- Dual-pane: Project tree (33 projects) + Session list (1.2K sessions)
- Dual-pane: Project tree + Session list
- Metadata: timestamps, duration, tokens, models
- Search: Filter by project, message, or model (press `/`)
- File operations: `e` to edit JSONL, `o` to reveal in finder
@ -94,14 +94,14 @@ cargo install ccboard
#### 6. Costs (Press `6`)
- 3 views: Overview | By Model | Daily Trend
- Token breakdown: input, output, cache read/write
- Pricing: $9,145.20 total estimated
- Model distribution: Opus 4.5 (76%), Sonnet 4.5 (14%)
- Pricing: total estimated costs
- Model distribution breakdown
#### 7. History (Press `7`)
- Full-text search across 2,311 sessions
- Full-text search across all sessions
- Activity by hour histogram (24h)
- 7-day sparkline
- 297.9K messages searchable
- All messages searchable
#### 8. MCP (Press `8`) **NEW**
- Dual-pane: Server list (35%) | Details (65%)
@ -204,7 +204,7 @@ The MCP tab provides comprehensive server monitoring:
/sessions
# Press '/' to search
# Filter by project: /aristote
# Filter by project: /my-project
# Filter by model: /opus
# Press 'e' on session to view full JSONL
```
@ -368,7 +368,7 @@ Future roadmap:
ccboard is open source (MIT OR Apache-2.0).
Repository: https://github.com/FlorianBruniaux/ccboard
Repository: https://github.com/{OWNER}/ccboard
Contributions welcome:
- Bug reports and feature requests
@ -393,6 +393,6 @@ MIT OR Apache-2.0
**Questions?**
- GitHub Issues: https://github.com/FlorianBruniaux/ccboard/issues
- Documentation: https://github.com/FlorianBruniaux/ccboard
- GitHub Issues: https://github.com/{OWNER}/ccboard/issues
- Documentation: https://github.com/{OWNER}/ccboard
- Claude Code: https://claude.ai/code

2
examples/skills/ccboard/commands/install.md
View file

@ -81,7 +81,7 @@ source $HOME/.cargo/env
rustup update
# Try manual installation from source
git clone https://github.com/FlorianBruniaux/ccboard
git clone https://github.com/{OWNER}/ccboard
cd ccboard
cargo install --path crates/ccboard
```

2
examples/skills/ccboard/commands/sessions.md
View file

@ -56,7 +56,7 @@ Each session shows:
```
# Search by project name
/aristote
/my-project
# Search by model
/opus

2
examples/skills/ccboard/scripts/install-ccboard.sh
View file

@ -78,7 +78,7 @@ else
echo " 1. Ensure cargo is up to date: rustup update"
echo " 2. Check network connection"
echo " 3. Try manual installation from source:"
echo " git clone https://github.com/FlorianBruniaux/ccboard"
echo " git clone https://github.com/{OWNER}/ccboard"
echo " cd ccboard"
echo " cargo install --path crates/ccboard"
exit 1

11
examples/skills/guide-recap/SKILL.md
View file

@ -2,6 +2,7 @@
name: guide-recap
description: Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Newsletter, Slack) in FR + EN. Use after releases or weekly to generate ready-to-post content from guide updates.
argument-hint: "<latest|vX.Y.Z|week [YYYY-MM-DD]> [--interactive] [--format=linkedin|twitter|newsletter|slack] [--lang=fr|en] [--save]"
tags: [changelog, social-media, content, linkedin, twitter]
---
# Guide Recap
@ -30,7 +31,7 @@ Generate social media content from CHANGELOG.md entries. Produces 8 outputs by d
| `--interactive` | Guide mode: choose angle, audience, highlight | Off (auto-draft) |
| `--format=X` | Single format: `linkedin`, `twitter`, `newsletter`, `slack` | All 4 formats |
| `--lang=X` | Single language: `fr`, `en` | Both FR + EN |
| `--save` | Save output to `claudedocs/social-posts/` | Display only |
| `--save` | Save output to `[project-docs]/social-posts/` | Display only |
| `--force` | Generate even if only maintenance entries | Skip low-score |
## Workflow (7 Steps)
@ -154,8 +155,8 @@ For each requested format (default: all 4) and language (default: both):
| Slack | GitHub repo URL |
**URLs:**
- Landing: `https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/`
- GitHub: `https://github.com/FlorianBruniaux/claude-code-ultimate-guide`
- Landing: `https://{DOMAIN}/`
- GitHub: `https://github.com/{OWNER}/{REPO}`
### Step 7: Output
@ -183,7 +184,7 @@ Display each generated post in a fenced code block, labeled by format and langua
...
```
If `--save` flag: write all outputs to `claudedocs/social-posts/YYYY-MM-DD-vX.Y.Z.md` (for version) or `claudedocs/social-posts/YYYY-MM-DD-week.md` (for week). Create `claudedocs/social-posts/` directory if it doesn't exist.
If `--save` flag: write all outputs to `[project-docs]/social-posts/YYYY-MM-DD-vX.Y.Z.md` (for version) or `[project-docs]/social-posts/YYYY-MM-DD-week.md` (for week). Create `[project-docs]/social-posts/` directory if it doesn't exist.
## Error Handling
@ -213,5 +214,5 @@ If `--save` flag: write all outputs to `claudedocs/social-posts/YYYY-MM-DD-vX.Y.
- Run `/guide-recap latest` right after `/release` to prepare social posts
- Use `--interactive` the first few times to understand the scoring
- Use `--format=linkedin --lang=fr` when you only need one specific output
- `--save` outputs are gitignored via `claudedocs/` convention
- `--save` outputs are gitignored via `[project-docs]/` convention
- Review and personalize before posting (these are drafts, not final copy)

16
examples/skills/guide-recap/examples/version-output.md
View file

@ -26,7 +26,7 @@ Guide v3.20.5 - La reference visuelle s'enrichit.
- Defense securite 3 couches : prevention, detection, reponse avec parcours d'adoption par taille d'equipe
- Timeline d'exposition de secrets : actions d'urgence par fenetre (15min/1h/24h)
Guide complet disponible en open source : https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
Guide complet disponible en open source : https://{DOMAIN}/
#ClaudeCode #CodingWithAI #DeveloperTools
```
@ -43,7 +43,7 @@ Guide v3.20.5 - Visual reference update.
- Security 3-Layer Defense: prevention, detection, response with adoption path by team size
- Secret Exposure Timeline: emergency actions by time window (15min/1h/24h)
Full guide available open source: https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
Full guide available open source: https://{DOMAIN}/
#ClaudeCode #CodingWithAI #DeveloperTools
```
@ -55,7 +55,7 @@ Full guide available open source: https://florianbruniaux.github.io/claude-code-
TDD, UVAL, securite 3 couches, timeline incidents - reference visuelle v3.20.5
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
https://github.com/{OWNER}/{REPO}
```
### Twitter/X (EN)
@ -65,7 +65,7 @@ https://github.com/FlorianBruniaux/claude-code-ultimate-guide
TDD, UVAL, 3-layer security, incident timeline - visual reference v3.20.5
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
https://github.com/{OWNER}/{REPO}
```
### Newsletter (FR)
@ -92,7 +92,7 @@ Si vous apprenez mieux en visuel, les 20 diagrammes du guide couvrent maintenant
---
[Guide complet](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) | [GitHub](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)
[Guide complet](https://{DOMAIN}/) | [GitHub](https://github.com/{OWNER}/{REPO})
```
### Newsletter (EN)
@ -119,7 +119,7 @@ If you're a visual learner, the guide's 20 diagrams now cover the most common wo
---
[Full guide](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) | [GitHub](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)
[Full guide](https://{DOMAIN}/) | [GitHub](https://github.com/{OWNER}/{REPO})
```
### Slack (FR)
@ -130,7 +130,7 @@ If you're a visual learner, the guide's 20 diagrams now cover the most common wo
:art: 4 nouveaux diagrammes ASCII (TDD, UVAL, securite, incidents)
:arrow_right: 16 -> 20 diagrammes au total
:link: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
:link: https://github.com/{OWNER}/{REPO}
```
### Slack (EN)
@ -141,5 +141,5 @@ If you're a visual learner, the guide's 20 diagrams now cover the most common wo
:art: 4 new ASCII diagrams (TDD, UVAL, security, incidents)
:arrow_right: 16 -> 20 diagrams total
:link: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
:link: https://github.com/{OWNER}/{REPO}
```

16
examples/skills/guide-recap/examples/week-output.md
View file

@ -44,7 +44,7 @@ Semaine du 27 janvier : la plus grosse semaine de contenu depuis le lancement du
- 4 nouveaux diagrammes ASCII pour TDD, UVAL, securite et incidents
- Workflow de code review multi-agent base sur le travail de Pat Cullen : 3 agents specialises, regles anti-hallucination, classification de severite
Guide complet en open source : https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
Guide complet en open source : https://{DOMAIN}/
#ClaudeCode #CodingWithAI #DeveloperTools
```
@ -61,7 +61,7 @@ Week of January 27: the biggest content week since the guide launched.
- 4 new ASCII diagrams for TDD, UVAL, security, and incidents
- Multi-agent code review workflow based on Pat Cullen's work: 3 specialized agents, anti-hallucination rules, severity classification
Full guide available open source: https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/
Full guide available open source: https://{DOMAIN}/
#ClaudeCode #CodingWithAI #DeveloperTools
```
@ -88,7 +88,7 @@ Code review multi-agent (Pat Cullen)
Sandbox isolation Docker
Metriques Anthropic : +67% PRs/jour
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
https://github.com/{OWNER}/{REPO}
```
### Twitter/X (EN)
@ -113,7 +113,7 @@ Multi-agent code review (Pat Cullen)
Docker sandbox isolation
Anthropic metrics: +67% PRs/day
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
https://github.com/{OWNER}/{REPO}
```
### Newsletter (FR)
@ -142,7 +142,7 @@ Cette semaine marque un tournant vers les patterns avances et la qualite de code
---
[Guide complet](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) | [GitHub](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)
[Guide complet](https://{DOMAIN}/) | [GitHub](https://github.com/{OWNER}/{REPO})
```
### Newsletter (EN)
@ -171,7 +171,7 @@ This week marks a shift toward advanced patterns and code quality. If you use Cl
---
[Full guide](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) | [GitHub](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)
[Full guide](https://{DOMAIN}/) | [GitHub](https://github.com/{OWNER}/{REPO})
```
### Slack (FR)
@ -185,7 +185,7 @@ This week marks a shift toward advanced patterns and code quality. If you use Cl
:wrench: Code review multi-agent (Pat Cullen) : 3 agents, anti-hallucination, convergence
:shield: Guide sandbox isolation Docker
:link: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
:link: https://github.com/{OWNER}/{REPO}
```
### Slack (EN)
@ -199,5 +199,5 @@ This week marks a shift toward advanced patterns and code quality. If you use Cl
:wrench: Multi-agent code review (Pat Cullen): 3 agents, anti-hallucination, convergence
:shield: Docker sandbox isolation guide
:link: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
:link: https://github.com/{OWNER}/{REPO}
```

4
examples/skills/landing-page-generator/SKILL.md
View file

@ -205,11 +205,11 @@ Generate these sections in order:
## Example
**User**: `/landing-page-generator from ~/Sites/perso/cc-copilot-bridge --risk-banner --pricing-table`
**User**: `/landing-page-generator from ~/projects/my-project --risk-banner --pricing-table`
**Output**:
Creates `/Users/florianbruniaux/Sites/perso/cc-copilot-bridge-landing/` with:
Creates `~/projects/my-project-landing/` with:
- Complete landing page showcasing the multi-provider router
- Prominent ToS risk banner (orange, above fold)
- Provider cards (Anthropic, Copilot, Ollama)

65
examples/skills/release-notes-generator/SKILL.md
View file

@ -1,11 +1,12 @@
---
name: release-notes-generator
description: Generate release notes in 3 formats (CHANGELOG.md, PR body, Slack announcement) from git commits. Automatically categorizes changes and converts technical language to user-friendly messaging. Use when preparing a production release.
tags: [release-notes, changelog, slack, git, automation]
---
# Release Notes Generator
Generate comprehensive release notes in 3 formats from git commits, optimized for the Methode Aristote project workflow.
Generate comprehensive release notes in 3 formats from git commits.
## When to Use This Skill
@ -60,25 +61,25 @@ Technical format for developers:
```markdown
## [0.18.0] - 2025-12-08
### Objectif
### Objective
[1-2 sentence summary]
### Nouvelles Fonctionnalites
### New Features
#### [Feature Name] (#PR)
- **Description**: ...
- **Impact**: ...
### Corrections de Bugs
- **[Module]**: Description (#issue, Sentry ISSUE-XX)
### Bug Fixes
- **[Module]**: Description (#issue, [error-tracker] ISSUE-XX)
### Ameliorations Techniques
### Technical Improvements
#### Performance / UI/UX / Architecture
- [Description]
### Migrations Base de Donnees
### Database Migrations
[If applicable]
### Statistiques
### Statistics
- PRs: X
- Features: Y
- Bugs: Z
@ -89,7 +90,7 @@ Technical format for developers:
Uses template from `.github/PULL_REQUEST_TEMPLATE/release.md`:
- Objective summary
- Features with specs links
- Bug fixes with Sentry references
- Bug fixes with error tracker references
- Improvements by category
- Migration instructions
- Deployment checklist
@ -99,13 +100,13 @@ Uses template from `.github/PULL_REQUEST_TEMPLATE/release.md`:
Product-focused format from `.github/COMMUNICATION_TEMPLATE/slack-release.md`:
- **PR link** included for traceability
- Non-technical language
- Focus on user impact (tuteurs, eleves, admin)
- Focus on user impact (end-users, admins, stakeholders)
- Emojis for readability
- Statistics summary
## Workflow Integration
This skill integrates with the release workflow in CLAUDE.md Section VI.5:
This skill integrates with the release workflow:
```
1. Analyze commits: git log <last-tag>..HEAD
@ -123,13 +124,13 @@ The skill automatically transforms technical language:
| Technical | Product |
|-----------|---------|
| "Optimisation N+1 queries avec DataLoader" | "Chargement plus rapide des listes" |
| "Implementation embeddings AI avec pgvector" | "Nouvelle recherche intelligente d'activites" |
| "Correction scope permissions dans getPermissionScope()" | "Correction d'un bug d'acces aux sessions" |
| "Migration webpack -> Turbopack" | *Ne pas communiquer* |
| "Refactorisation hooks React" | *Ne pas communiquer* |
| "Fix N+1 in user loaders" | "Amelioration des performances" |
| "Add retry logic for Prisma P1001" | "Meilleure stabilite de connexion" |
| "N+1 query optimization with DataLoader" | "Faster list loading" |
| "AI embeddings implementation with pgvector" | "New intelligent search" |
| "Fix scope permissions in getPermissionScope()" | "Fixed access permissions bug" |
| "Migration webpack -> Turbopack" | *Do not communicate* |
| "React hooks refactoring" | *Do not communicate* |
| "Fix N+1 in user loaders" | "Performance improvement" |
| "Add retry logic for DB connection errors" | "Better connection stability" |
## Commit Categories
@ -137,10 +138,10 @@ Commits are categorized by conventional commit prefix:
| Prefix | Category | Include in Slack? |
|--------|----------|-------------------|
| `feat:` | Nouvelles Fonctionnalites | Yes |
| `fix:` | Corrections de Bugs | Yes (if user-facing) |
| `feat:` | New Features | Yes |
| `fix:` | Bug Fixes | Yes (if user-facing) |
| `perf:` | Performance | Yes (simplified) |
| `security:` | Securite | Yes |
| `security:` | Security | Yes |
| `refactor:` | Architecture | No |
| `chore:` | Maintenance | No |
| `docs:` | Documentation | No |
@ -157,16 +158,16 @@ If migrations are detected, display prominently:
```
╔══════════════════════════════════════════════════════════════════╗
║ ⚠️ [ATTENTION] MIGRATIONS BASE DE DONNÉES REQUISES ║
║ ⚠️ [WARNING] DATABASE MIGRATIONS REQUIRED ║
╠══════════════════════════════════════════════════════════════════╣
║ ║
║ Cette release contient X migration(s) Prisma : ║
║ This release contains X migration(s): ║
║ ║
║ • 20251210123456_add_activity_description ║
║ • 20251211094532_update_session_status ║
║ • 20251210123456_add_feature_description ║
║ • 20251211094532_update_status_enum ║
║ ║
║ Action requise AVANT déploiement : ║
║ → Exécuter : pnpm prisma migrate deploy ║
║ Action required BEFORE deployment: ║
║ → Run: [migration-command] ║
║ ║
╚══════════════════════════════════════════════════════════════════╝
```
@ -174,7 +175,7 @@ If migrations are detected, display prominently:
If NO migrations:
```
✅ [OK] Aucune migration base de données requise
✅ [OK] No database migrations required
```
### Detection Method
@ -183,7 +184,7 @@ Check for new migration files since last release:
```bash
# Find new migrations since last tag
git diff <last-tag>..HEAD --name-only -- prisma/migrations/
git diff <last-tag>..HEAD --name-only -- migrations/
```
## Example
@ -203,11 +204,11 @@ Found:
- 3 improvements
╔══════════════════════════════════════════════════════════════════╗
║ ⚠️ [ATTENTION] MIGRATIONS BASE DE DONNÉES REQUISES ║
║ ⚠️ [WARNING] DATABASE MIGRATIONS REQUIRED ║
╠══════════════════════════════════════════════════════════════════╣
║ Cette release contient 1 migration(s) Prisma : ║
║ This release contains 1 migration(s): ║
║ • 20251208143021_add_user_preferences ║
║ Action requise : pnpm prisma migrate deploy ║
║ Action required: [migration-command] ║
╚══════════════════════════════════════════════════════════════════╝
--- CHANGELOG.md Section ---

92
examples/skills/release-notes-generator/assets/changelog-template.md
View file

@ -5,89 +5,89 @@ Use this template for generating CHANGELOG.md entries.
```markdown
## [X.Y.Z] - YYYY-MM-DD
### Objectif
[Resume en 1-2 phrases de cette release]
### Objective
[1-2 sentence summary of this release]
### Nouvelles Fonctionnalites
### New Features
#### [Feature Name] (#PR_NUMBER)
- **Description** : [Description fonctionnelle claire]
- **Spec Notion** : [Lien vers la spec si disponible]
- **Composants impactes** : `component-a`, `service-b`, etc.
- **Impact** : [Qui est concerne : Tuteurs / Eleves / Admin / Tous]
- **Description** : [Clear functional description]
- **Spec link** : [Link to spec if available]
- **Impacted components** : `component-a`, `service-b`, etc.
- **Impact** : [Who is affected: End-users / Admins / All]
### Corrections de Bugs
### Bug Fixes
#### [Module/Composant] (#PR_NUMBER)
- **Issue** : [Description du bug]
- **Cause** : [Cause racine identifiee]
- **Fix** : [Description de la correction]
- **Sentry** : METHODE-ARISTOTE-APP-XX (si applicable)
#### [Module/Component] (#PR_NUMBER)
- **Issue** : [Bug description]
- **Cause** : [Root cause identified]
- **Fix** : [Fix description]
- **[Error tracker]** : PROJECT-XX (if applicable)
### Ameliorations Techniques
### Technical Improvements
#### Performance
- [Description optimisation avec impact mesurable si possible]
- [Optimization description with measurable impact if possible]
#### UI/UX
- [Description amelioration interface]
- [Interface improvement description]
#### Architecture
- [Description refactoring important]
- [Significant refactoring description]
### Securite
- **[CVE-XXXX-XXXXX]** : [Description et impact]
### Security
- **[CVE-XXXX-XXXXX]** : [Description and impact]
### Migrations Base de Donnees
### Database Migrations
#### Processus de Deploiement
#### Deployment Process
**Etape 1 : Appliquer les migrations Prisma**
**Step 1: Apply migrations**
```bash
pnpm prisma migrate deploy
[migration-command]
```
**Etape 2 : Scripts de data migration** (si applicable)
**Step 2: Data migration scripts** (if applicable)
```bash
pnpm dotenv -e .env.production -- tsx scripts/db/migrations/[script-name].ts
[data-migration-command]
```
**Verification post-migration**
**Post-migration verification**
```sql
-- Requetes de verification
-- Verification queries
SELECT COUNT(*) FROM [table];
```
### Breaking Changes
**Aucun** ou:
**None** or:
- **[Composant/API]** : Description du breaking change
- **Migration requise** : Comment migrer
- **Impact** : Qui est affecte
- **[Component/API]** : Breaking change description
- **Migration required** : How to migrate
- **Impact** : Who is affected
### Deprecations
**Aucune** ou:
**None** or:
- **[Fonctionnalite X]** : Depreciee dans cette version
- **Raison** : Pourquoi
- **Alternative** : Quoi utiliser a la place
- **Suppression prevue** : Version X.Y.Z
- **[Feature X]** : Deprecated in this version
- **Reason** : Why
- **Alternative** : What to use instead
- **Planned removal** : Version X.Y.Z
### Tests
- [X] tests unitaires pour [feature]
- [X] tests d'integration pour [module]
- [X] unit tests for [feature]
- [X] integration tests for [module]
### Statistiques
### Statistics
- **PRs** : #XX, #YY, #ZZ
- **Fichiers impactes** : XX+
- **Nouvelles tables** : [liste si applicable]
- **Migrations Prisma** : X migrations
- **Files impacted** : XX+
- **New tables** : [list if applicable]
- **Migrations** : X migrations
- **Breaking changes** : 0
### Liens
- PR: https://github.com/methode-aristote/app/pull/XXX
- PRs incluses : #XX, #YY, #ZZ
- Issues Sentry : METHODE-ARISTOTE-APP-XX
### Links
- PR: https://github.com/{owner}/{repo}/pull/XXX
- Included PRs : #XX, #YY, #ZZ
- [Error tracker] issues : PROJECT-XX
```

90
examples/skills/release-notes-generator/assets/slack-template.md
View file

@ -3,83 +3,83 @@
Use this template for generating product-focused Slack messages.
```
Version X.Y.Z - Deployee en production
Version X.Y.Z - Deployed to production
PR : [URL de la PR de release, ex: https://github.com/methode-aristote/app/pull/XXX]
PR : [Release PR URL, e.g.: https://github.com/{owner}/{repo}/pull/XXX]
En bref : [Phrase decrivant l'objectif principal de cette release]
In brief : [Sentence describing the main objective of this release]
---
Nouvelles fonctionnalites
New Features
[Nom Feature 1]
> [Description en 1-2 phrases de ce que ca apporte aux utilisateurs]
> Qui est concerne : [Tuteurs / Eleves / Admin / Tous]
[Feature Name 1]
> [1-2 sentence description of user impact]
> Who is affected: [End-users / Admins / All]
[Nom Feature 2]
> [Description en 1-2 phrases]
> Qui est concerne : [Roles]
[Feature Name 2]
> [1-2 sentence description]
> Who is affected: [Roles]
---
Corrections importantes
Important Fixes
- [Description du bug corrige en langage utilisateur]
- [Description du bug corrige en langage utilisateur]
- [Bug fix described in user-friendly language]
- [Bug fix described in user-friendly language]
---
Ameliorations
Improvements
- [Amelioration UX/UI ou workflow en langage utilisateur]
- [UX/UI or workflow improvement in user language]
- [...]
---
En chiffres
By the numbers
- X nouvelles fonctionnalites
- Y bugs corriges
- Z ameliorations
- X new features
- Y bugs fixed
- Z improvements
---
Questions ? Contactez @florian ou l'equipe tech
Questions? Contact @[team-lead] or the dev team
```
## Guidelines
### A FAIRE
- Utiliser un langage accessible (pas de jargon technique)
- Focus sur l'impact utilisateur
- Etre concis (max 10 lignes par section)
- Utiliser des emojis avec parcimonie
### DO
- Use accessible language (no technical jargon)
- Focus on user impact
- Be concise (max 10 lines per section)
- Use emojis sparingly
### A EVITER
- "Implementation du pattern DataLoader pour resoudre les N+1 queries"
- "Refactorisation complete du systeme de permissions avec scope ANY/ASSIGNED"
- "Migration de webpack vers Turbopack"
### AVOID
- "Implementation of the DataLoader pattern to solve N+1 queries"
- "Complete refactoring of the permissions system with scope ANY/ASSIGNED"
- "Migration from webpack to Turbopack"
### Transformation Tech -> Produit
### Tech -> Product Transformation
| Technique | Produit |
| Technical | Product |
|-----------|---------|
| Optimisation N+1 queries avec DataLoader | Chargement plus rapide des listes d'utilisateurs et de sessions |
| Implementation embeddings AI avec pgvector | Nouvelle recherche intelligente d'activites similaires |
| Correction scope permissions dans getPermissionScope() | Correction d'un bug qui empechait certains utilisateurs d'acceder a leurs sessions |
| Migration vers kebab-case pour les fichiers | *Ne pas communiquer (purement technique)* |
| Fix Prisma P1001 avec retry logic | Meilleure stabilite de connexion a la base de donnees |
| Add Sentry monitoring for orphan chats | Detection automatique des conversations orphelines |
| N+1 query optimization with DataLoader | Faster loading of user and feature lists |
| AI embeddings implementation with pgvector | New intelligent search for similar items |
| Fix scope permissions in getPermissionScope() | Fixed a bug preventing some users from accessing their data |
| Migration to kebab-case for files | *Do not communicate (purely technical)* |
| Fix DB connection with retry logic | Better database connection stability |
| Add error monitoring for orphan records | Automatic detection of orphan records |
### Sections Optionnelles
### Optional Sections
Si la release contient des elements importants, ajouter:
If the release contains important items, add:
Points d'attention
- [Information importante que les utilisateurs doivent savoir]
- [Changement de comportement qu'ils pourraient remarquer]
Heads up
- [Important information users should know]
- [Behavior changes they might notice]
A venir prochainement
- [Teaser de la prochaine grosse feature]
- [Feature en cours de developpement qui arrive bientot]
Coming soon
- [Teaser for the next big feature]
- [Feature in development coming soon]

62
examples/skills/release-notes-generator/references/commit-categories.md
View file

@ -5,38 +5,38 @@ This document defines how to categorize commits based on Conventional Commits fo
## Primary Categories
### Features (`feat:`)
**CHANGELOG**: Nouvelles Fonctionnalites
**CHANGELOG**: New Features
**Slack**: Yes - always include
**Examples**:
- `feat(session): add parent report system`
- `feat(activity): add multi-level topics`
- `feat(search): add accent-insensitive search`
- `feat(dashboard): add export report system`
- `feat(search): add fuzzy matching`
- `feat(api): add batch operations endpoint`
### Bug Fixes (`fix:`)
**CHANGELOG**: Corrections de Bugs
**CHANGELOG**: Bug Fixes
**Slack**: Yes - if user-facing; No - if internal
**Examples**:
- `fix(session): correct status transition` -> Include in Slack
- `fix(auth): correct token refresh flow` -> Include in Slack
- `fix(test): correct mock setup` -> Do NOT include in Slack
### Performance (`perf:`)
**CHANGELOG**: Ameliorations Techniques > Performance
**Slack**: Yes - simplified ("Performances ameliorees")
**CHANGELOG**: Technical Improvements > Performance
**Slack**: Yes - simplified ("Performance improvement")
**Examples**:
- `perf(loader): optimize N+1 queries with batching`
- `perf(api): optimize N+1 queries with batching`
- `perf(build): reduce bundle size by 30%`
### Security (`security:` or `fix(security):`)
**CHANGELOG**: Securite
**CHANGELOG**: Security
**Slack**: Yes - always, with appropriate detail level
**Examples**:
- `security: fix CVE-2025-55182 React2Shell RCE`
- `fix(security): prevent XSS in chat messages`
- `security: fix CVE-2025-55182 dependency RCE`
- `fix(security): prevent XSS in user input`
## Secondary Categories (CHANGELOG only)
### Refactoring (`refactor:`)
**CHANGELOG**: Ameliorations Techniques > Architecture
**CHANGELOG**: Technical Improvements > Architecture
**Slack**: No
**Examples**:
- `refactor(hooks): migrate to new pattern`
@ -47,14 +47,14 @@ This document defines how to categorize commits based on Conventional Commits fo
**Slack**: No
**Examples**:
- `docs: update CLAUDE.md with new patterns`
- `docs(api): add tRPC endpoint documentation`
- `docs(api): add endpoint documentation`
### Tests (`test:`)
**CHANGELOG**: Tests (count only)
**Slack**: No
**Examples**:
- `test(activity): add prompt resolver tests`
- `test(e2e): add session workflow tests`
- `test(api): add endpoint integration tests`
- `test(e2e): add workflow tests`
### Chores (`chore:`)
**CHANGELOG**: No (unless significant)
@ -72,28 +72,26 @@ This document defines how to categorize commits based on Conventional Commits fo
## Scope Patterns
Common scopes in Methode Aristote:
Common scopes:
| Scope | Area |
|-------|------|
| `session` | Session management |
| `activity` | Activities and prompts |
| `chat` | Chat and AI features |
| `user` | User management |
| `auth` | Authentication |
| `visio` | Video conferencing |
| `training` | Training/Formation system |
| `admin` | Admin panel |
| `calendar` | Calendar and scheduling |
| `permissions` | Permission system |
| `db` | Database and migrations |
| `billing` | Billing and payments |
| `api` | API endpoints |
| `ui` | UI components |
| `dashboard` | Dashboard features |
| `notifications` | Notification system |
| `search` | Search functionality |
| `user` | User management |
| `db` | Database and migrations |
| `permissions` | Permission system |
| `admin` | Admin panel |
## Breaking Changes
Indicated by `!` after type/scope or `BREAKING CHANGE:` in footer:
- `feat(api)!: change session status enum`
- `feat(api)!: change status enum`
- `fix(auth)!: require new token format`
**CHANGELOG**: Breaking Changes section
@ -106,11 +104,11 @@ Extract PR numbers from:
2. Merge commit: `Merge pull request #123`
3. GitHub API: cross-reference with commit SHA
## Sentry Issue Linking
## Error Tracker Issue Linking
Match patterns:
- `Sentry: METHODE-ARISTOTE-APP-XX`
- `fixes METHODE-ARISTOTE-APP-XX`
- `[error-tracker]: PROJECT-XX`
- `fixes PROJECT-XX`
- `closes #XX` (GitHub issue)
## Statistics Calculation
@ -121,4 +119,4 @@ Count for release stats:
- **Bugs**: `fix:` commits (excluding test/internal)
- **Improvements**: `perf:` + `refactor:` + UI improvements
- **Security**: `security:` commits
- **Breaking**: Commits with `!` or `BREAKING CHANGE`
- **Breaking**: Commits with `!` or `BREAKING CHANGE`

80
examples/skills/release-notes-generator/references/tech-to-product-mappings.md
View file

@ -8,16 +8,16 @@ This document defines how to transform technical commit messages into user-frien
| Technical Pattern | Product Message |
|-------------------|-----------------|
| `N+1 queries`, `DataLoader`, `batching` | "Chargement plus rapide des listes" |
| `embeddings`, `vector search`, `pgvector` | "Recherche intelligente amelioree" |
| `permissions`, `scope`, `access control` | "Correction d'un bug d'acces" |
| `retry logic`, `resilience`, `P1001` | "Meilleure stabilite de connexion" |
| `SSE`, `real-time`, `WebSocket` | "Mises a jour en temps reel" |
| `cache`, `memoization` | "Performances ameliorees" |
| `responsive`, `mobile` | "Meilleure experience mobile" |
| `accessibility`, `a11y`, `WCAG` | "Accessibilite amelioree" |
| `Sentry`, `monitoring`, `alerting` | "Meilleur suivi des erreurs" |
| `validation`, `sanitization` | "Securite renforcee" |
| `N+1 queries`, `DataLoader`, `batching` | "Faster list loading" |
| `embeddings`, `vector search`, `pgvector` | "Improved intelligent search" |
| `permissions`, `scope`, `access control` | "Fixed an access bug" |
| `retry logic`, `resilience`, `connection errors` | "Better connection stability" |
| `SSE`, `real-time`, `WebSocket` | "Real-time updates" |
| `cache`, `memoization` | "Improved performance" |
| `responsive`, `mobile` | "Better mobile experience" |
| `accessibility`, `a11y`, `WCAG` | "Improved accessibility" |
| `monitoring`, `alerting`, `error tracking` | "Better error tracking" |
| `validation`, `sanitization` | "Enhanced security" |
### 2. DO NOT COMMUNICATE (Internal/Technical only)
@ -40,32 +40,32 @@ These patterns should NOT appear in Slack announcements:
| Technical | Product |
|-----------|---------|
| `CVE-XXXX-XXXXX` | "Correction d'une vulnerabilite de securite" |
| `XSS`, `injection` | "Renforcement de la protection des donnees" |
| `authentication`, `auth bypass` | "Securite de connexion amelioree" |
| `CORS`, `CSRF` | "Protection contre les attaques web" |
| `CVE-XXXX-XXXXX` | "Fixed a security vulnerability" |
| `XSS`, `injection` | "Enhanced data protection" |
| `authentication`, `auth bypass` | "Improved login security" |
| `CORS`, `CSRF` | "Protection against web attacks" |
## Context-Aware Transformations
### Session-related
- "Fix session status transition" -> "Correction du suivi des seances"
- "Add session conflict detection" -> "Detection automatique des conflits de planning"
- "Improve visio sync" -> "Synchronisation video amelioree"
### API-related
- "Fix endpoint rate limiting" -> "Improved API stability"
- "Add request validation" -> "Better input handling"
- "Optimize query performance" -> "Faster data loading"
### User-related
- "Fix user profile access" -> "Correction de l'acces aux profils"
- "Add accent-insensitive search" -> "Recherche amelioree (accents non sensibles)"
- "Improve user loader performance" -> "Chargement des utilisateurs plus rapide"
### Dashboard-related
- "Fix dashboard widget rendering" -> "Fixed display issues on dashboard"
- "Add export functionality" -> "New data export feature"
- "Improve chart performance" -> "Faster dashboard loading"
### Activity-related
- "Fix activity prompt resolution" -> "Correction de l'affichage des activites"
- "Add multi-level topics" -> "Organisation des activites par niveau amelioree"
- "Improve embeddings generation" -> "Recherche d'activites similaires amelioree"
### Notification-related
- "Fix email delivery queue" -> "Improved notification reliability"
- "Add webhook retry logic" -> "More reliable integrations"
- "Optimize notification batching" -> "Faster notification delivery"
### Chat-related
- "Fix streaming race condition" -> "Stabilite du chat amelioree"
- "Add vocal history" -> "Historique des messages vocaux"
- "Prevent empty messages" -> "Correction des messages vides"
### Search-related
- "Fix search indexing race condition" -> "Improved search reliability"
- "Add fuzzy matching" -> "Better search results"
- "Optimize search query execution" -> "Faster search"
## Role-Based Impact
@ -73,19 +73,19 @@ Always specify who is affected:
| Impact | Roles |
|--------|-------|
| Dashboard changes | Tuteurs, Eleves, Admin |
| Session management | Tuteurs, Admin |
| Activity library | Tuteurs, Admin |
| Chat/AI features | Tuteurs, Eleves |
| Admin panel | Admin only |
| Billing/Payment | Admin, Parents |
| Reports/Analytics | Admin, Tuteurs |
| Dashboard changes | End-users, Admins |
| API changes | End-users, Power users |
| Admin panel | Admins only |
| Billing/Payment | Admins, Stakeholders |
| Reports/Analytics | Admins, Power users |
| Notifications | All users |
| Search | All users |
## Severity Indicators
Use these prefixes when appropriate:
- **Critique** : Production-blocking issues
- **Critical** : Production-blocking issues
- **Important** : User-facing bugs
- **Mineur** : Quality of life improvements
- *Ne pas mentionner* : Internal fixes
- **Minor** : Quality of life improvements
- *Do not mention* : Internal fixes