Cuerpo de SKILL.md y archivos de referencia
Escribe instrucciones detalladas y enlaza contexto externo
⏱ Estim. ~5 min
01 · Leer
El cuerpo markdown debajo del frontmatter es donde está la verdadera potencia. Aquí escribes las instrucciones detalladas, ejemplos, restricciones y reglas que Claude debe seguir.
Piénsalo como un manual de instrucciones altamente específico para una tarea.
Usa encabezados markdown para organizar secciones, listas para reglas y bloques de código para ejemplos. Cuanto más claro y específico seas, más consistente será Claude.
Un cuerpo que diga "escribe buen código" no sirve: Claude ya lo intenta. Un cuerpo que diga "usa camelCase para variables, PascalCase para componentes React y kebab-case para clases CSS" sí se puede aplicar.
Puntos clave
- El cuerpo es markdown libre: encabezados, listas, bloques de código, negrita
- Sé explícito: "usa camelCase para variables" vence a "usa buenos nombres"
- Incluye ejemplos de cómo se ve una buena salida
- Organiza con encabezados para que Claude encuentre rápido las reglas relevantes
02 · Ejemplo de código
Aquí tienes un skill "API Developer" con un cuerpo rico en estructura: encabezados, reglas y ejemplos de código.
api-developer/SKILL.md (sección del cuerpo)
## 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 lee cada encabezado, lista y ejemplo de código. Cuando más tarde le digas "ayúdame a crear un endpoint GET /users", seguirá automáticamente estas convenciones: URLs en kebab-case, JSON en camelCase y el formato de error exacto que especificaste.
03 · Leer
A veces tus instrucciones hacen referencia a conocimiento externo: schemas de bases de datos, guías de estilo, definiciones de tipos, plantillas.
En lugar de pegar todo eso dentro del SKILL.md (que se vuelve enorme y difícil de mantener), puedes enlazar archivos de referencia.
Van en la misma carpeta del skill que el SKILL.md y se referencian desde el cuerpo. Cuando el skill se activa, Claude lee los archivos enlazados como contexto adicional.
La ventaja de los archivos de referencia: son la fuente real de la verdad. Cuando cambia tu schema, Claude ve la versión más reciente automáticamente — no tienes que actualizar el skill manualmente.
Puntos clave
- Los archivos de referencia viven en la misma carpeta del skill que SKILL.md
- Aportan contexto sin inflar el archivo del skill
- Referencias comunes: archivos de schema, guías de estilo, plantillas, definiciones de tipos
- Los archivos de referencia se mantienen al día porque son la fuente de la verdad
04 · Ejemplo de código
Aquí tienes un skill que enlaza un schema de Prisma como archivo de referencia, dándole a Claude conocimiento completo de la estructura de tu base de datos.
Estructura de carpetas
.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
Cuando este skill se activa, Claude puede leer schema.prisma para entender la estructura de tu base de datos. Cuando cambies el schema más tarde, Claude verá la versión más reciente automáticamente — no hay que actualizar el skill.
05 · Quiz
Imagina que el schema de tu base de datos cambia con frecuencia. ¿Por qué usar un archivo de referencia en lugar de pegar el schema directamente en SKILL.md?
- Los archivos de referencia cargan más rápido que el contenido en línea
- SKILL.md tiene un límite estricto de 100 líneas
- Claude solo puede leer archivos separados de SKILL.md
- Los archivos de referencia se mantienen al día con la fuente y mantienen SKILL.md enfocado
06 · Emparejar
Has aprendido las cuatro partes de un skill. Empareja cada componente con lo que hace — piensa dónde viven los metadatos, las instrucciones y el contexto externo.
(Esta sección es interactiva — activa JavaScript para usarla.)
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.