Notre avis

Génère un modèle de compétence personnalisé à partir d'instructions ou de workflows répétés, en empaquetant l'expertise que les agents IA chargent automatiquement.

Points forts

Automatise des instructions répétitives en compétences réutilisables
Réduit l'effort manuel en empaquetant l'expertise
Suit la spécification officielle des compétences pour la compatibilité
Fournit des étapes de validation et de confirmation utilisateur

Limites

Nécessite au moins 2-3 répétitions pour justifier une compétence
Sortie limitée à 500 lignes ; les compétences plus longues nécessitent un dossier references/
Ne fonctionne qu'avec les agents IA supportant les compétences (principalement Claude Code)

Quand l'utiliser

Lorsque vous répétez des instructions similaires à un agent IA 2 à 3 fois avec 90 % de contenu identique.

Quand l'éviter

Lorsque la tâche est ponctuelle ou que les instructions varient considérablement entre les utilisations.

Exemples

Create a skill for code review

I keep asking you to review my code using the same conventions. Generate a skill for that.

Package my commit message workflow

I've given you the same instructions for commit messages three times now. Turn it into a skill.

Automate project setup

Every time I start a new project, I want you to follow the same setup steps. Make it a skill.

name: 'aidd:01:generate_skill' description: 'Generate a customized skill based on repeated patterns and user workflows.' argument-hint: 'Description of the workflow to package as a skill'

Goal

Generate a skill template from repeated instructions or workflows, packaging expertise that AI agents load automatically.

Context

Official skills specification

These rules come from the official Claude Code documentation. Interpret them in a generalist and agnostic way (applicable to other AI tools).

@https://code.claude.com/docs/en/skills.md

Skill template

@aidd_docs/templates/aidd/skill.md

Existing skills

@.claude/skills/

IDE Mapping

Mandatory mapping for IDE integration (file paths, naming, extensions):

@.claude/rules/04-tooling/ide-mapping.md

Rules

Frontmatter rules

name: lowercase, dashes for spaces, max 64 chars
description:
- 3rd person ("Generates...", "Creates..."), max 1024 chars
- MUST include "Use when..." with explicit triggers
- Include natural keywords users would say

Content rules

Skill is worth it if instructions repeated 2-3x
SKILL.md < 500 lines (otherwise → references/)
Max 1 level of references (agent does not read nested refs)
Less is more - do not over-explain the obvious

Process Steps

Auto-detect IDE: Check which IDE folders exist and ask user to confirm
Identify the pattern
- Verify that the same instructions have been given to the AI at least 2-3 times
- Confirm that 90% of instructions are identical between usages
- Ensure the task requires specific conventions
Ask clarifying questions
- What triggers/contexts should activate this skill?
- What keywords does the user naturally use?
- Are there scripts or references to include?
Structure the skill: respect the given template
Validate with user
- Display the generated SKILL.md
- Request confirmation before writing
- Propose folder: .claude/skills/<skill-name>/
Output
- Write to .claude/skills/<skill-name>/SKILL.md
- Add references/ folder if > 500 lines

Génération de compétence personnalisée

Recommandé pour