Corps du SKILL.md et fichiers de référence
Écrire des instructions détaillées, lier du contexte externe
⏱ Estim. ~5 min
01 · Lire
Le corps markdown sous le frontmatter, c'est là que se trouve la vraie puissance. C'est là que tu écris des instructions détaillées, des exemples, des contraintes, des règles que Claude doit suivre.
Vois ça comme un manuel d'instructions ultra-précis pour une tâche.
Utilise des titres markdown pour structurer les sections, des listes à puces pour les règles, des blocs de code pour les exemples. Plus tu es clair et concret, plus Claude est cohérent.
Un corps qui dit « écris du bon code » ne sert à rien — Claude essaie déjà. Un corps qui dit « utilise camelCase pour les variables, PascalCase pour les composants React, kebab-case pour les classes CSS » est applicable.
Points clés
- Le corps est du markdown libre — titres, listes, blocs de code, gras
- Sois explicite : « variables en camelCase » bat « utilise un bon nommage »
- Inclus des exemples de ce à quoi ressemble une bonne sortie
- Structure avec des titres, pour que Claude trouve vite les règles pertinentes
02 · Exemple de code
Voici un skill « API Developer », avec un corps riche en structure : titres, règles, exemples de code.
api-developer/SKILL.md (section corps)
## API Conventions
- All endpoints return JSON
- Use kebab-case for URL paths: `/user-profiles` not `/userProfiles`
- Use camelCase for JSON fields: `{ "firstName": "Ada" }`
- Always include `Content-Type: application/json` header
## Error Response Format
Always return errors in this exact shape:
```json
{
"error": {
"code": "NOT_FOUND",
"message": "User with id 42 not found"
}
}
```
## Status Code Rules
- 200 for successful reads
- 201 for successful creates
- 400 for invalid input
- 404 for missing resources
- 500 should never be intentional — fix the bug
Claude lit chaque titre, chaque puce, chaque exemple de code. Quand tu lui dis ensuite « aide-moi à créer un endpoint GET /users », Claude suit automatiquement ces conventions — URL en kebab-case, JSON en camelCase, le format d'erreur exact que tu as spécifié.
03 · Lire
Parfois tes instructions font référence à des connaissances externes — schéma de base de données, style guide, définitions de types, templates.
Plutôt que de tout coller dans SKILL.md (il devient énorme et difficile à maintenir), tu peux lier des fichiers de référence.
Mets-les dans le même dossier de skill que SKILL.md, et référence-les depuis le corps. Quand le skill s'active, Claude lit les fichiers liés comme contexte supplémentaire.
L'avantage des fichiers de référence : ce sont la vraie source de vérité. Si ton schéma change, Claude voit automatiquement la dernière version — pas besoin de mettre à jour le skill à la main.
Points clés
- Les fichiers de référence vivent dans le même dossier de skill que SKILL.md
- Ils donnent du contexte sans alourdir le fichier de skill
- Fichiers de référence courants : fichiers de schéma, style guides, templates, définitions de types
- Les fichiers de référence restent à jour, parce qu'ils sont la source de vérité
04 · Exemple de code
Voici un skill qui lie un schéma Prisma comme fichier de référence — il donne à Claude une connaissance complète de la structure de ta base de données.
Structure du dossier
.claude/skills/db-developer/
├── SKILL.md
└── schema.prisma
db-developer/SKILL.md
---
name: Database Developer
description: Writes database queries and migrations following our schema
---
## Context
Our database schema is defined in `schema.prisma` (included in this skill folder).
Always reference it when writing queries or migrations.
## Rules
- Never use raw SQL — use Prisma Client
- Always include `createdAt` and `updatedAt` on new models
- Foreign keys must have `onDelete: Cascade` unless specified otherwise
- Index any column used in WHERE clauses
Quand ce skill est activé, Claude peut lire schema.prisma pour comprendre la structure de ta base de données. Si tu changes le schéma ensuite, Claude voit automatiquement la dernière version — pas besoin de mettre à jour le skill.
05 · Quiz
Imagine que ton schéma de base de données change souvent. Pourquoi utiliser un fichier de référence plutôt que coller le schéma directement dans SKILL.md ?
- Les fichiers de référence se chargent plus vite que le contenu inline
- Un SKILL.md a une limite stricte de 100 lignes
- Claude ne peut lire que des fichiers séparés de SKILL.md
- Les fichiers de référence restent à jour avec leur source et gardent SKILL.md focalisé
06 · Associer
Tu as vu les quatre parties d'un skill. Associe chaque composant à ce qu'il fait — pense à où vivent les métadonnées, les instructions et le contexte externe.
(Cette section est interactive — active JavaScript pour l'utiliser.)
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.