Étendre Claude avec des skills

​

Compétences groupées

​

Vérifier votre configuration avec /doctor

• État de l’installation : installations en double ou résiduelles, problèmes de PATH, fichiers de paramètres impossibles à analyser, et disponibilité d’une version plus récente sur votre canal de publication
• Extensions : skills, serveurs MCP et plugins inutilisés comparés à leur coût en contexte, et hooks lents
• Fichiers CLAUDE.md : fichiers CLAUDE.md locaux qui dupliquent ceux versionnés dans le dépôt, contenu de CLAUDE.md que Claude pourrait déduire de la base de code versionné dans le dépôt, et les consignes toujours chargées restantes, que Claude propose de migrer vers des skills et des fichiers CLAUDE.md imbriqués chargés à la demande
• Permissions : une proposition de faire du mode auto votre mode de permission par défaut et de pré-approuver les commandes en lecture seule que vous refusez fréquemment
• Utilisation : avec un forfait Pro, Max, Ultra, Team ou Enterprise, les modifications recommandées par /usage pour réduire l’utilisation de votre forfait, mesurée sur les 7 derniers jours. Claude propose les modifications qu’il peut effectuer lui-même et présente le reste sous forme de conseils, comme une commande à exécuter vous-même. La vérification de l’utilisation nécessite Claude Code v2.1.305 ou version ultérieure, et /doctor l’omet lorsque Remote Control est connecté.

​

Exécuter et vérifier votre application

​

Exécuter vos vérifications avant chaque commit

• Emplacement : le skill est chargé depuis l’emplacement entreprise, personnel, projet ou répertoire supplémentaire, ou depuis un fichier .claude/commands/ portant ce nom. La recette que /verify enregistre à la racine de votre référentiel est un skill de projet, elle compte donc. Les /verify et /simplify fournis, les skills de plugin et les skills de votre compte claude.ai ne comptent pas.
• Invocation : Claude peut invoquer le skill. Si vous avez empêché Claude de l’invoquer, par exemple avec disable-model-invocation: true, Claude ne reçoit pas l’instruction.
• Instructions Git : vous n’avez pas désactivé includeGitInstructions. Le désactiver supprime cette instruction ainsi que le reste des instructions intégrées de commit et de PR.

​

Travailler sur les projets Claude API

​

Démarrage

​

Créer votre première compétence

mkdir -p ~/.claude/skills/summarize-changes

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

What did I change?

/summarize-changes

​

Choisir où les skills se chargent

• Dossiers liés par lien symbolique : une entrée <skill-name> dans l’emplacement entreprise, personnel ou projet peut être un lien symbolique vers un répertoire situé ailleurs sur le disque. Claude Code lit SKILL.md depuis la cible et charge le skill une seule fois, même si plusieurs emplacements pointent vers la même cible. Les skills de plugin gèrent les liens symboliques différemment.
• Nom réservé synced : ne nommez pas un dossier de skill synced, quelle que soit la casse. Claude Code utilise ~/.claude/skills/synced/ pour les skills téléchargés depuis claude.ai et ignore un skill que vous créez sous ce nom dans les emplacements entreprise, personnel et projet.
• Nom réservé anthropic-skills : en dehors d’un plugin, un dossier de skill ou un fichier de commande dont le nom est anthropic-skills ou commence par anthropic-skills: ne se charge pas. Voir Noms réservés aux skills synchronisés.
• Caractères dans le nom : en dehors d’un plugin, un dossier de skill ne se charge pas lorsque son nom contient un caractère tel qu’une espace de largeur nulle ou <. Voir Caractères qu’un nom de skill ne peut pas contenir.
• Fichiers de commande : un fichier Markdown dans .claude/commands/ correspond à l’ancien format et fonctionne toujours. Il prend en charge le même frontmatter, à l’exception de name et paths. Pour trouver le nom à saisir pour l’invoquer, consultez Comment un skill obtient son nom de commande. Privilégiez un skill pour tout nouveau travail, car les skills prennent également en charge les fichiers complémentaires.
• Dossier de skill en tant que plugin : ajoutez un .claude-plugin/plugin.json à un dossier de skill personnel ou de projet, et Claude Code peut le charger comme un plugin nommé <name>@skills-dir doté de ses propres agents, hooks et serveurs MCP. Dans le .claude/skills/ d’un projet, cela nécessite d’abord d’accepter la boîte de dialogue de confiance de l’espace de travail, et dans les deux emplacements, cela nécessite que votre administrateur n’ait pas bloqué les plugins de répertoire de skills.

​

Charger des skills dans les monorepos et les sous-répertoires

• /deploy exécute le skill racine. Claude Code liste également pour Claude les variantes qualifiées par répertoire, avec l’instruction d’invoquer celle dont le répertoire contient les fichiers sur lesquels il travaille, de sorte que le skill imbriqué s’applique toujours au travail dans apps/web/.
• /apps/web:deploy exécute uniquement le skill imbriqué. Sa description nomme le répertoire auquel il s’applique.

​

Charger des skills depuis un répertoire extérieur au projet

​

Exécuter un skill homonyme depuis un répertoire ajouté

• /verify exécute le skill de votre projet
• /cli:verify exécute le skill de ../cli

​

Résoudre les skills qui partagent un nom

​

Utiliser des skills dans les sessions Cowork et cloud

• Pour les sessions Cowork, les sessions cloud et les threads cloud d’un projet, activez le skill pour votre compte claude.ai. Dans le thread cloud d’un projet, les skills commités dans le .claude/skills/ d’un dépôt ne sont pas disponibles. Certaines sessions dans un environnement auto-hébergé ne chargent pas les skills de votre compte.
• Pour les sessions cloud autres que les threads de projet, vous pouvez à la place créer un commit du skill dans le .claude/skills/ du dépôt. Les plugins déclarés dans le .claude/settings.json du dépôt et les plugins activés uniquement dans vos paramètres utilisateur ne se chargent pas dans les sessions cloud.

​

Skills synchronisés depuis claude.ai

​

Où se chargent les skills synchronisés

• Pendant que vous ou Claude travaillez dans la session : une vérification s’exécute environ toutes les 10 minutes.
• Pendant que la session est inactive : une vérification s’exécute environ toutes les 40 minutes. Lorsque vous saisissez à nouveau du texte dans la session, Claude Code effectue une vérification dans les quelques minutes si la dernière remonte à plus de 10 minutes.

• Une session qui n’utilise pas une connexion enregistrée par /login, par exemple une session qui s’authentifie avec une clé API, ou une session où ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN ou un script apiKeyHelper fournit les identifiants
• Une session qui ne récupère pas les feature flags, par exemple une session sur Amazon Bedrock ou une session où vous définissez CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
• Une session en mode bare ou une session que vous démarrez avec --safe-mode
• Une session où les paramètres gérés de votre organisation limitent les skills aux sources de plugins, ou une session que vous démarrez avec une liste --setting-sources qui omet user

​

Lorsque le nom d’un skill synchronisé correspond à une autre commande

• Une commande intégrée ou un skill fourni, y compris un skill indisponible dans votre session, par exemple après que vous avez désactivé les skills fournis
• Un skill à n’importe quel niveau local ou un fichier dans .claude/commands/
• Un skill de plugin
• Un prompt MCP

​

Noms réservés aux skills synchronisés

• Un dossier de skill, un name de frontmatter, un fichier ou sous-dossier dans .claude/commands/, ou un workflow enregistré : il ne se charge pas. Un avis au démarrage indique le premier élément à renommer ou modifier.
• Un plugin nommé anthropic-skills : il se charge. Lorsque l’un de ses skills et un skill synchronisé sont tous deux nommés <name>, /anthropic-skills:<name> exécute le skill synchronisé.
• Un serveur MCP nommé anthropic-skills : il se connecte et ses outils fonctionnent, mais ses prompts n’apparaissent pas comme des commandes. Renommez le serveur dans votre configuration MCP pour les lister.

​

Comment Claude Code gère le frontmatter d’un skill synchronisé

• Le frontmatter s’applique dans tous les types de session : une autorisation allowed-tools passe donc par le flux de permissions normal. Si votre organisation définit allowManagedPermissionRulesOnly, l’autorisation ne s’applique pas.
• Claude Code nettoie le texte d’affichage fourni par le skill, tel que sa description. Il supprime les caractères de contrôle et, dans le texte qui parvient à Claude, comme la description, il échappe également les chevrons afin que le texte ne puisse pas imiter le formatage interne de Claude Code. Ce nettoyage nécessite Claude Code v2.1.228 ou ultérieure.

​

Comment Claude Code gère le corps d’un skill synchronisé

• Dans une session cloud, le corps conserve le comportement d’un skill local, car la session s’exécute dans un conteneur isolé.
• Dans une session Cowork sur votre ordinateur, le corps conserve le comportement d’un skill local, sauf que Claude Code remplace chaque ligne de commande ! par le placeholder disableSkillShellExecution, comme il le fait pour chaque skill que vous y fournissez.
• Dans toute autre session sur votre machine, Claude Code n’exécute pas les commandes !, n’attache pas les fichiers nommés par les références @ comme il le fait pour un skill local, et ne substitue pas les placeholders ${CLAUDE_PROJECT_DIR} et ${CLAUDE_SESSION_ID} : les références @ et les deux placeholders parviennent donc à Claude sous forme de texte littéral. Une ligne de commande ! parvient également à Claude sous forme de texte littéral, ou sous la forme de ce placeholder lorsque disableSkillShellExecution est activé. Ce traitement nécessite Claude Code v2.1.228 ou ultérieure.

​

Modifier un skill pendant une session

​

Supprimer un skill

• Skill personnel ou de projet : supprimez le répertoire du skill, ~/.claude/skills/<skill-name>/ ou .claude/skills/<skill-name>/. Claude Code le retire de /skills dans la session en cours ; le contenu que Claude Code en a déjà chargé suit le cycle de vie du contenu des skills.
• Skill d’entreprise : un administrateur supprime le répertoire du skill de .claude/skills/ dans le répertoire des paramètres gérés, par exemple /etc/claude-code/.claude/skills/<skill-name>/ sous Linux.
• Skill de plugin : désactivez ou désinstallez le plugin qui le fournit, depuis le menu /plugin ou avec /plugin uninstall <plugin-name>@<marketplace-name>. Claude Code décharge les skills du plugin lorsque la modification s’applique ou lorsque vous redémarrez.
• Skill synchronisé depuis claude.ai : désactivez le skill pour votre compte claude.ai, au même endroit où vous l’avez activé. Claude Code le supprime de ~/.claude/skills/synced/ lors de la prochaine synchronisation de vos skills. Si vous supprimez plutôt le répertoire manuellement, la synchronisation suivante le télécharge à nouveau tant que le skill reste activé sur claude.ai.
• Skill fourni : définissez disableBundledSkills sur true pour désactiver les skills fournis, ou définissez un skill sur "off" dans skillOverrides pour le masquer.

​

Configurer les compétences

​

Types de contenu de compétence

---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation

---
name: deploy
description: Deploy the application to production
context: fork
disable-model-invocation: true
---

Deploy the application:
1. Run the test suite
2. Build the application
3. Push to the deployment target

​

Référence du frontmatter

---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---

Your skill instructions here...

​

Utiliser le frontmatter de compétence en dehors de Claude Code

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

​

Comment une compétence obtient son nom de commande

​

Caractères qu’un nom de skill ne peut pas contenir

• Un espace sans chasse ou un caractère de contrôle
• Un caractère à usage privé ou non attribué, comme un glyphe provenant d’une police d’icônes
• Un caractère qui modifie la direction du texte qui l’entoure
• Un blanc autre qu’un simple espace entre les mots, comme un espace insécable, deux espaces consécutifs, ou un espace au début ou à la fin
• < ou >

• Dossier dans le répertoire skills/ d’un plugin ou dans les chemins skills de son manifeste : vous n’avez pas besoin de renommer le dossier. Ces caractères deviennent des tirets dans le nom de commande du skill, tapez donc la commande avec les tirets.
• name du frontmatter : le menu / n’affiche pas la valeur de name et la taper n’invoque pas le skill. Modifiez la ligne name: pour supprimer les caractères.

​

Substitutions de chaîne disponibles

---
name: render-chart
description: Render a chart from a CSV file
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/render.sh *)
---

Run `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-file>` to render the chart.

---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS

​

Ajouter des fichiers de support

my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
    └── helper.py (utility script - executed, not loaded)

## Additional resources

- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)

​

Contrôler qui invoque une compétence

• disable-model-invocation: true : Claude ne peut pas invoquer le skill de lui-même. Utilisez ceci pour les workflows avec des effets secondaires ou dont vous souhaitez contrôler le timing, comme /commit, /deploy ou /send-slack-message. Vous ne voulez pas que Claude décide de déployer parce que votre code semble prêt.
• user-invocable: false : Seul Claude peut invoquer la compétence. Utilisez ceci pour les connaissances de base qui ne sont pas actionnables en tant que commande. Une compétence legacy-system-context explique comment fonctionne un ancien système. Claude devrait le savoir lorsqu’il est pertinent, mais /legacy-system-context n’est pas une action significative pour les utilisateurs.

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy $ARGUMENTS to production:

1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded

​

Où écrire le nom du skill

​

Cycle de vie du contenu de la compétence

​

Pré-approuver les outils pour une compétence

---
name: commit
description: Stage and commit the current changes
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---

​

Quand les paramètres gérés réservent les hooks aux plugins

• Vérifier : tapez /status dans une session Claude Code. Si /status affiche Enterprise managed settings, demandez à votre administrateur si strictPluginOnlyCustomization liste hooks.
• Corriger : supprimez hooks du frontmatter du skill, car ses hooks ne s’exécutent pas avec ce paramètre. Pour les conserver, déplacez le skill dans un plugin que vous installez depuis une marketplace.

​

Quand seules les règles de permission gérées s’appliquent

​

Passer des arguments aux compétences

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $ARGUMENTS[0] component from $ARGUMENTS[1] to $ARGUMENTS[2].
Preserve all existing behavior and tests.

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

​

Empiler plusieurs skills dans un même message

​

Modèles avancés

​

Injecter du contexte dynamique

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

## Environment
```!
node --version
git status --short
```

​

Comment les commandes injectées s’exécutent

• shell: powershell, avec l’outil PowerShell activé : les commandes s’exécutent via l’outil PowerShell.
• shell: bash lorsque bash n’est pas disponible : l’invocation échoue avant l’exécution de toute commande. Cela se produit sur Windows sans Git Bash. Claude Code affiche Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found.
• Toute autre combinaison : les commandes s’exécutent via l’outil Bash lorsque bash est disponible. Sinon, elles s’exécutent via l’outil PowerShell.

• Répertoire de travail : Claude Code exécute chaque commande dans le répertoire de travail actuel du shell de la session. Ce répertoire se déplace lorsque Claude exécute cd. Utilisez ${CLAUDE_SKILL_DIR} ou ${CLAUDE_PROJECT_DIR} dans les chemins qui doivent se résoudre de la même manière à chaque fois.
• stderr : avec le shell bash par défaut, Claude Code fusionne stderr dans stdout. Tout ce que la commande écrit dans stderr apparaît dans le texte injecté.
• Délai d’expiration : chaque commande s’exécute sous le délai d’expiration par défaut de 2 minutes de l’outil Bash. Lorsque l’outil Bash déplace une commande expirée en arrière-plan, la compétence s’affiche toujours. Le texte injecté signale le déplacement et nomme la tâche en arrière-plan et le fichier collectant la sortie de la commande. Lorsque la commande est une que l’outil Bash ne met jamais automatiquement en arrière-plan, Claude Code la tue au délai d’expiration. Cet échec abandonne l’invocation.
• Taille de la sortie : la sortie au-delà du plafond en ligne de l’outil Bash arrive sous la forme d’un chemin de fichier plus un court aperçu, pas du texte tronqué. Output limits couvre le plafond et comment ajuster chaque limite.

​

Quand une commande injectée échoue

• Shell bash par défaut : les commandes listées sous Output limits
• shell: powershell, lorsque l’outil PowerShell est activé : un ensemble différent qui inclut grep et git diff mais pas find ou diff

​

Quand aucune commande shell n’a été exécutée

​

Vérifications des permissions sur les commandes injectées

​

Exécuter les compétences dans un sous-agent

• En mode non-interactif, avec le drapeau -p ou le SDK Agent
• Lorsque vous définissez CLAUDE_CODE_DISABLE_BACKGROUND_TASKS sur 1, ce qui désactive également les autres fonctionnalités de tâche en arrière-plan
• Lorsque vous invoquez une compétence forkée alors qu’une invocation antérieure de la même compétence s’exécute toujours
• Lorsqu’une tâche planifiée limitée à la session se déclenche avec le skill comme prompt

​

Exemple : Compétence de recherche utilisant l’agent Explore

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

1. Un nouveau contexte isolé est créé
2. Le sous-agent reçoit le contenu de la compétence comme son invite (les instructions « Research $ARGUMENTS thoroughly »)
3. Le champ agent détermine l’environnement d’exécution (modèle, outils et permissions)
4. Le sous-agent résume ses résultats et les retourne à votre conversation principale lorsqu’il se termine

​

Restreindre l’accès aux compétences de Claude

# Add to deny rules:
Skill

# Allow only specific skills
Skill(commit)
Skill(review-pr *)

# Deny specific skills
Skill(deploy *)

• Skill(anthropic-skills:pdf) approuve la compétence synchronisée pdf
• Skill(anthropic-skills *) approuve chaque compétence synchronisée
• Skill(anthropic *) ne couvre pas anthropic-skills:pdf, car un préfixe en dehors de l’espace de noms ne correspond pas aux noms à l’intérieur

​

Remplacer la visibilité des compétences à partir des paramètres

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

​

Trouver les compétences inutilisées

​

Évaluer et itérer sur une compétence

• Compétence personnelle ou de projet : définissez-la sur "off" dans skillOverrides.
• Compétence fournie par un plugin : skillOverrides ne s’applique pas aux compétences de plugin. Utilisez claude plugin eval à la place, qui répète chaque exécution sans plugin chargé.

​

Exécuter des évaluations avec skill-creator

/plugin install skill-creator@claude-plugins-official

• Marketplace "claude-plugins-official" not found : ajoutez la marketplace avec /plugin marketplace add anthropics/claude-plugins-official, puis réessayez l’installation.
• Plugin "<name>" not found in marketplace "claude-plugins-official" : votre copie locale du catalogue de la marketplace est peut-être obsolète. Actualisez-la avec /plugin marketplace update claude-plugins-official, puis réessayez l’installation. Si la nouvelle tentative affiche le même message, consultez Plugin introuvable dans la marketplace.

• Cas de test : stocke les invites, les fichiers d’entrée et le comportement attendu dans evals/evals.json à l’intérieur du répertoire de compétence
• Exécutions isolées : génère un sous-agent par cas de test afin que chaque exécution commence avec un contexte propre, et enregistre le nombre de tokens et la durée
• Notation : vérifie chaque assertion par rapport à la sortie et écrit réussi ou échoué avec des preuves dans grading.json
• Benchmark : agrège le taux de réussite, le temps et les tokens pour avec-compétence par rapport à sans-compétence dans benchmark.json afin que vous puissiez comparer l’amélioration du taux de réussite par rapport à la surcharge de tokens et de temps
• Comparaison de versions : exécute un A/B en aveugle entre deux versions de la compétence afin que vous puissiez confirmer qu’une modification est une amélioration avant de la valider
• Ajustement de description : génère des invites should-trigger et should-not-trigger, mesure le taux de réussite, et propose des modifications de description quand la compétence s’active sur les mauvaises demandes
• Visionneuse d’examen : ouvre un rapport HTML où vous inspectez chaque sortie et enregistrez les commentaires qualitatifs que l’itération suivante lit

​

Partager des compétences

• Compétences de projet : Validez .claude/skills/ dans le contrôle de version
• Plugins : Créez un répertoire skills/ dans votre plugin
• Gérées : Déployez à l’échelle de l’organisation via les paramètres gérés

​

Générer une sortie visuelle

mkdir -p ~/.claude/skills/codebase-visualizer/scripts

---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase. Use when exploring a new repo, understanding project structure, or identifying large files.
allowed-tools: Bash(python3 *)
---

# Codebase Visualizer

Generate an interactive HTML tree view that shows your project's file structure with collapsible directories.

## Usage

Run the visualization script from your project root:

```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .
```

This creates `codebase-map.html` in the current directory and opens it in your default browser.

## What the visualization shows

- **Collapsible directories**: Click folders to expand/collapse
- **File sizes**: Displayed next to each file
- **Colors**: Different colors for different file types
- **Directory totals**: Shows aggregate size of each folder

• Une barre latérale de résumé affichant le nombre de fichiers, le nombre de répertoires, la taille totale et le nombre de types de fichiers
• Un graphique en barres ventilant la base de code par type de fichier (top 8 par taille)
• Un arbre réductible où vous pouvez développer et réduire les répertoires, avec des indicateurs de type de fichier codés par couleur

#!/usr/bin/env python3
"""Generate an interactive collapsible tree visualization of a codebase."""

import json
import sys
import webbrowser
from html import escape
from pathlib import Path
from collections import Counter

IGNORE = {'.git', 'node_modules', '__pycache__', '.venv', 'venv', 'dist', 'build'}

def scan(path: Path, stats: dict) -> dict:
    result = {"name": path.name, "children": [], "size": 0}
    try:
        for item in sorted(path.iterdir()):
            if item.name in IGNORE or item.name.startswith('.'):
                continue
            if item.is_file():
                size = item.stat().st_size
                ext = item.suffix.lower() or '(no ext)'
                result["children"].append({"name": item.name, "size": size, "ext": ext})
                result["size"] += size
                stats["files"] += 1
                stats["extensions"][ext] += 1
                stats["ext_sizes"][ext] += size
            elif item.is_dir():
                stats["dirs"] += 1
                child = scan(item, stats)
                if child["children"]:
                    result["children"].append(child)
                    result["size"] += child["size"]
    except PermissionError:
        pass
    return result

def generate_html(data: dict, stats: dict, output: Path) -> None:
    ext_sizes = stats["ext_sizes"]
    total_size = sum(ext_sizes.values()) or 1
    sorted_exts = sorted(ext_sizes.items(), key=lambda x: -x[1])[:8]
    colors = {
        '.js': '#f7df1e', '.ts': '#3178c6', '.py': '#3776ab', '.go': '#00add8',
        '.rs': '#dea584', '.rb': '#cc342d', '.css': '#264de4', '.html': '#e34c26',
        '.json': '#6b7280', '.md': '#083fa1', '.yaml': '#cb171e', '.yml': '#cb171e',
        '.mdx': '#083fa1', '.tsx': '#3178c6', '.jsx': '#61dafb', '.sh': '#4eaa25',
    }
    lang_bars = "".join(
        f'<div class="bar-row"><span class="bar-label">{ext}</span>'
        f'<div class="bar" style="width:{(size/total_size)*100}%;background:{colors.get(ext,"#6b7280")}"></div>'
        f'<span class="bar-pct">{(size/total_size)*100:.1f}%</span></div>'
        for ext, size in sorted_exts
    )
    def fmt(b):
        if b < 1024: return f"{b} B"
        if b < 1048576: return f"{b/1024:.1f} KB"
        return f"{b/1048576:.1f} MB"

    html = f'''<!DOCTYPE html>
<html><head>
  <meta charset="utf-8"><title>Codebase Explorer</title>
  <style>
    body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }}
    .container {{ display: flex; height: 100vh; }}
    .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }}
    .main {{ flex: 1; padding: 20px; overflow-y: auto; }}
    h1 {{ margin: 0 0 10px 0; font-size: 18px; }}
    h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }}
    .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }}
    .stat-value {{ font-weight: bold; }}
    .bar-row {{ display: flex; align-items: center; margin: 6px 0; }}
    .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }}
    .bar {{ height: 18px; border-radius: 3px; }}
    .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }}
    .tree {{ list-style: none; padding-left: 20px; }}
    details {{ cursor: pointer; }}
    summary {{ padding: 4px 8px; border-radius: 4px; }}
    summary:hover {{ background: #2d2d44; }}
    .folder {{ color: #ffd700; }}
    .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }}
    .file:hover {{ background: #2d2d44; }}
    .size {{ color: #888; margin-left: auto; font-size: 12px; }}
    .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }}
  </style>
</head><body>
  <div class="container">
    <div class="sidebar">
      <h1>📊 Summary</h1>
      <div class="stat"><span>Files</span><span class="stat-value">{stats["files"]:,}</span></div>
      <div class="stat"><span>Directories</span><span class="stat-value">{stats["dirs"]:,}</span></div>
      <div class="stat"><span>Total size</span><span class="stat-value">{fmt(data["size"])}</span></div>
      <div class="stat"><span>File types</span><span class="stat-value">{len(stats["extensions"])}</span></div>
      <h2>By file type</h2>
      {lang_bars}
    </div>
    <div class="main">
      <h1>📁 {escape(data["name"])}</h1>
      <ul class="tree" id="root"></ul>
    </div>
  </div>
  <script>
    const data = {json.dumps(data)};
    const colors = {json.dumps(colors)};
    function fmt(b) {{ if (b < 1024) return b + ' B'; if (b < 1048576) return (b/1024).toFixed(1) + ' KB'; return (b/1048576).toFixed(1) + ' MB'; }}
    function esc(s) {{ return s.replace(/[&<>"']/g, c => ({{"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}}[c])); }}
    function render(node, parent) {{
      if (node.children) {{
        const det = document.createElement('details');
        det.open = parent === document.getElementById('root');
        det.innerHTML = `<summary><span class="folder">📁 ${{esc(node.name)}}</span><span class="size">${{fmt(node.size)}}</span></summary>`;
        const ul = document.createElement('ul'); ul.className = 'tree';
        node.children.sort((a,b) => (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name));
        node.children.forEach(c => render(c, ul));
        det.appendChild(ul);
        const li = document.createElement('li'); li.appendChild(det); parent.appendChild(li);
      }} else {{
        const li = document.createElement('li'); li.className = 'file';
        li.innerHTML = `<span class="dot" style="background:${{colors[node.ext]||'#6b7280'}}"></span>${{esc(node.name)}}<span class="size">${{fmt(node.size)}}</span>`;
        parent.appendChild(li);
      }}
    }}
    data.children.forEach(c => render(c, document.getElementById('root')));
  </script>
</body></html>'''
    output.write_text(html)

if __name__ == '__main__':
    target = Path(sys.argv[1] if len(sys.argv) > 1 else '.').resolve()
    stats = {"files": 0, "dirs": 0, "extensions": Counter(), "ext_sizes": Counter()}
    data = scan(target, stats)
    out = Path('codebase-map.html')
    generate_html(data, stats, out)
    print(f'Generated {out.absolute()}')
    webbrowser.open(f'file://{out.absolute()}')

​

Dépannage

​

La compétence ne se déclenche pas

1. Vérifiez que la description inclut les mots-clés que les utilisateurs diraient naturellement
2. Vérifiez que la compétence apparaît dans What skills are available?
3. Essayez de reformuler votre demande pour correspondre plus étroitement à la description
4. Invoquez-la directement avec /skill-name si la compétence est invocable par l’utilisateur
5. Si /skill-name n’est pas reconnu non plus, vérifiez si Claude Code a refusé le nom du skill
6. Si le skill définit paths, vérifiez que les fichiers que Claude lit, modifie ou écrit se trouvent dans le répertoire de travail actuel de Claude. Le skill ne s’active pas pour les fichiers situés en dehors, comme ceux d’un worktree git voisin, même un worktree que vous avez ajouté avec /add-dir. Pour que le skill s’active pour ces fichiers, démarrez Claude Code dans ce worktree ou déplacez la session vers celui-ci avec /cd.

​

La compétence se déclenche trop souvent

1. Rendez la description plus spécifique
2. Ajoutez disable-model-invocation: true si vous ne voulez que l’invocation manuelle

​

Claude cesse de suivre une compétence

• Claude a ignoré une règle qui doit tenir à chaque fois : déplacez la règle dans un hook. Claude Code exécute un hook à chaque fois que son événement se produit, par exemple avant chaque modification de fichier, que Claude suive la compétence ou non. Pour garder la règle avec la compétence, définissez le hook dans le frontmatter hooks de la compétence. Ce hook s’applique à partir du moment où la compétence est invoquée jusqu’à la fin de la session.
• Claude a ignoré des conseils qu’il devrait appliquer avec jugement : formulez les conseils de manière à ce qu’ils s’appliquent à l’ensemble de la tâche, par exemple « Exécutez les tests après chaque modification » plutôt que « Exécutez les tests ». Claude Code ajoute le contenu de la compétence à la conversation quand la compétence est invoquée et ne relit pas le fichier aux tours suivants.
• La conversation a été compactée : invoquez la compétence à nouveau pour restaurer son contenu complet. Après compaction, Claude Code peut conserver uniquement le début d’une compétence invoquée, donc mettez les instructions les plus importantes près du haut de SKILL.md.

​

Les descriptions de compétences sont tronquées

​

Les chevrons dans une description de skill s’affichent sous la forme < et >

• Crochets : remplacez <branch> par [branch], qui s’affiche tel que saisi
• argument-hint : déplacez l’espace réservé vers une nouvelle ligne argument-hint: <branch>. Il s’affiche après le nom de la commande. Si vous téléversez également le skill sur claude.ai ou dans l’API Skills, vérifiez d’abord si argument-hint y est accepté.

​

Les compétences personnelles ont disparu

​

Ressources connexes

• Déboguer votre configuration : diagnostiquer pourquoi une skill n’apparaît pas ou ne se déclenche pas
• Évaluer la qualité de la sortie de la skill : le format du fichier eval et le flux de travail d’itération sur agentskills.io
• Meilleures pratiques de création de skills : conseils de rédaction qui s’appliquent à tous les produits Claude
• Subagents : déléguer les tâches à des agents spécialisés
• Plugins : empaqueter et distribuer les skills avec d’autres extensions
• Hooks : automatiser les workflows autour des événements d’outils
• Memory : gérer les fichiers CLAUDE.md pour le contexte persistant
• Commands : référence pour les commandes intégrées et les skills groupées
• Permissions : contrôler l’accès aux outils et aux skills
• Claude Tag skills : les skills de projet validées dans un repo se chargent également lorsque ce repo est utilisé dans un canal Claude Tag