Glosario de Claude Code

Skill frente a prompt

Una skill es un prompt guardado y reutilizable; un prompt es una instrucción única para un solo turno.

También llamado: skill or prompt, difference between skill and prompt, skill vs CLAUDE.md

Un prompt es una instrucción única que escribes; se aplica a ese turno y desaparece. Una skill es un prompt que te cansaste de volver a escribir, guardado como un archivo SKILL.md, con una descripción que permite a Claude cargarlo por sí mismo cuando sea relevante. La documentación oficial sugiere crear una skill cuando sigues pegando las mismas instrucciones, listas de verificación o procedimientos de varios pasos en el chat.

La distinción es más útil al considerar los tres contextos en los que opera Claude Code:

  • Prompt: Una única instrucción para el turno actual. No cuesta nada cuando no se usa y desaparece después del turno.
  • CLAUDE.md: Este archivo se carga en cada sesión al inicio. Debe contener el contexto que Claude siempre debe conocer, como comandos de compilación, convenciones de proyecto, diseño o reglas como 'siempre haz X'. Para mantenerlo eficiente, debe tener menos de 200 líneas.
  • Skill: Se carga bajo demanda. Las skills son más adecuadas para procedimientos, listas de verificación o material de referencia extenso que solo importa en ocasiones. La documentación establece explícitamente que si una entrada en CLAUDE.md representa un procedimiento de varios pasos o solo es relevante para una parte específica de la base de código, debe moverse a una skill o a una regla con ámbito de ruta.

Ninguno de estos son capas de aplicación; todos proporcionan contexto que Claude lee e intenta seguir. Para acciones que deben ocurrir independientemente de la decisión de Claude, usarías hooks.

Considera Authoring Skills para obtener orientación sobre cómo estructurar tus skills de manera efectiva. Si te encuentras escribiendo repetidamente el mismo prompt, es una señal fuerte de que una skill podría ser apropiada, en lugar de depender de prompts ad-hoc o saturar tu CLAUDE.md.

← Todos los términos del glosario