Génération d'Agent Skills

Repomix peut générer une sortie au format Claude Agent Skills, créant un répertoire structuré de Skills qui peut être utilisé comme référence de base de code réutilisable pour les assistants IA.

Cette fonctionnalité est particulièrement puissante lorsque vous souhaitez référencer des implémentations de dépôts distants. En générant des Skills à partir de projets open source, vous pouvez facilement demander à Claude de référencer des modèles ou implémentations spécifiques tout en travaillant sur votre propre code.

Au lieu de générer un seul fichier empaqueté, la génération de Skills crée un répertoire structuré avec plusieurs fichiers de référence optimisés pour la compréhension de l'IA et la recherche compatible avec grep.

NOTE

Il s'agit d'une fonctionnalité expérimentale. Le format de sortie et les options peuvent changer dans les futures versions en fonction des retours utilisateurs.

Utilisation de Base

Générer des Skills depuis votre répertoire local :

# Générer des Skills depuis le répertoire actuel
repomix --skill-generate

# Générer avec un nom de Skills personnalisé
repomix --skill-generate my-project-reference

# Générer depuis un répertoire spécifique
repomix path/to/directory --skill-generate

# Générer depuis un dépôt distant
repomix --remote https://github.com/user/repo --skill-generate

Sélection de l'Emplacement des Skills

Lorsque vous exécutez la commande, Repomix vous demande de choisir où sauvegarder les Skills :

1. Personal Skills (~/.claude/skills/) - Disponible pour tous les projets sur votre machine
2. Project Skills (.claude/skills/) - Partagé avec votre équipe via git

Si le répertoire Skills existe déjà, on vous demandera de confirmer l'écrasement.

TIP

Lors de la génération de Project Skills, envisagez de les ajouter à .gitignore pour éviter de commiter de gros fichiers :

.claude/skills/repomix-reference-*/

Structure Générée

Les Skills sont générés avec la structure suivante :

.claude/skills/<skill-name>/
├── SKILL.md                    # Métadonnées principales et documentation des Skills
└── references/
    ├── summary.md              # But, format et statistiques
    ├── project-structure.md    # Arborescence avec nombre de lignes
    ├── files.md                # Tout le contenu des fichiers (compatible grep)
    └── tech-stack.md           # Langages, frameworks, dépendances

Descriptions des Fichiers

SKILL.md

Le fichier principal des Skills contient :

• Nom des Skills, description et informations du projet
• Nombre de fichiers, de lignes et de tokens
• Aperçu de l'utilisation des Skills
• Emplacements des fichiers et explication du format
• Cas d'utilisation courants et conseils

references/summary.md

Contient :

• But : Explique qu'il s'agit d'une base de code de référence pour utilisation par l'IA
• Structure des Fichiers : Documente le contenu de chaque fichier de référence
• Directives d'Utilisation : Comment utiliser efficacement les Skills
• Statistiques : Répartition par type de fichier, langage et plus gros fichiers

references/project-structure.md

Arborescence avec nombre de lignes par fichier pour une découverte facile :

src/
  index.ts (42 lines)
  utils/
    helpers.ts (128 lines)
    math.ts (87 lines)

references/files.md

Tout le contenu des fichiers avec en-têtes de coloration syntaxique, optimisé pour la recherche compatible grep :

## File: src/index.ts
```typescript
import { sum } from './utils/helpers';

export function main() {
  console.log(sum(1, 2));
}
```

references/tech-stack.md

Stack technologique auto-détecté depuis les fichiers de dépendances :

• Langages : TypeScript, JavaScript, Python, etc.
• Frameworks : React, Next.js, Express, Django, etc.
• Versions Runtime : Node.js, Python, Go, etc.
• Gestionnaire de Paquets : npm, pnpm, poetry, etc.
• Dépendances : Toutes les dépendances directes et de développement
• Fichiers de Configuration : Tous les fichiers de configuration détectés

Détecté depuis des fichiers comme : package.json, requirements.txt, Cargo.toml, go.mod, .nvmrc, pyproject.toml, etc.

Noms de Skills Auto-Générés

Si aucun nom n'est fourni, Repomix en génère automatiquement un avec ce modèle :

repomix src/ --skill-generate                # → repomix-reference-src
repomix --remote user/repo --skill-generate  # → repomix-reference-repo
repomix --skill-generate CustomName          # → custom-name (normalisé en kebab-case)

Les noms de Skills sont :

• Convertis en kebab-case (minuscules, séparés par des tirets)
• Limités à 64 caractères maximum
• Protégés contre le path traversal

Intégration avec les Options Repomix

La génération de Skills respecte toutes les options standard de Repomix :

# Générer des Skills avec filtrage de fichiers
repomix --skill-generate --include "src/**/*.ts" --ignore "**/*.test.ts"

# Générer des Skills avec compression
repomix --skill-generate --compress

# Générer des Skills depuis un dépôt distant
repomix --remote yamadashy/repomix --skill-generate

# Générer des Skills avec des options de format de sortie spécifiques
repomix --skill-generate --remove-comments --remove-empty-lines

Skills Documentation Uniquement

En utilisant --include, vous pouvez générer des Skills contenant uniquement la documentation d'un dépôt GitHub. C'est utile quand vous voulez que Claude référence une documentation spécifique de bibliothèque ou framework pendant que vous travaillez sur votre code :

# Documentation Claude Code Action
repomix --remote https://github.com/anthropics/claude-code-action --include docs --skill-generate

# Documentation Vite
repomix --remote https://github.com/vitejs/vite --include docs --skill-generate

# Documentation React
repomix --remote https://github.com/reactjs/react.dev --include src/content --skill-generate

Limitations

L'option --skill-generate ne peut pas être utilisée avec :

• --stdout - La sortie Skills nécessite l'écriture sur le système de fichiers
• --copy - La sortie Skills est un répertoire, non copiable dans le presse-papiers

Utilisation des Skills Générés

Une fois générés, vous pouvez utiliser les Skills avec Claude :

1. Claude Code : Les Skills sont automatiquement disponibles s'ils sont sauvegardés dans ~/.claude/skills/ ou .claude/skills/
2. Claude Web : Téléchargez le répertoire Skills vers Claude pour l'analyse de base de code
3. Partage d'Équipe : Commitez .claude/skills/ dans votre dépôt pour un accès de toute l'équipe

Exemple de Workflow

Créer une Bibliothèque de Référence Personnelle

# Cloner et analyser un projet open source intéressant
repomix --remote facebook/react --skill-generate react-reference

# Les Skills sont sauvegardés dans ~/.claude/skills/react-reference/
# Maintenant vous pouvez référencer la base de code de React dans n'importe quelle conversation Claude

Documentation de Projet d'Équipe

# Dans votre répertoire de projet
cd my-project

# Générer des Skills pour votre équipe
repomix --skill-generate

# Choisissez "Project Skills" quand demandé
# Les Skills sont sauvegardés dans .claude/skills/repomix-reference-my-project/

# Commitez et partagez avec votre équipe
git add .claude/skills/
git commit -m "Add codebase reference Skills"

Ressources Connexes

• Plugins Claude Code - En savoir plus sur les plugins Repomix pour Claude Code
• Serveur MCP - Méthode d'intégration alternative
• Compression de Code - Réduire le nombre de tokens avec la compression
• Configuration - Personnaliser le comportement de Repomix