Descripción: Cómo crear instrucciones claras para Claude
Una vez que hayas decidido que una tarea merece ser delegada, la siguiente pregunta es cómo decirle a Claude lo que realmente necesitas.
//
Busca en todas las páginas de la documentación
Una vez que hayas decidido que una tarea merece ser delegada, la siguiente pregunta es cómo decirle a Claude lo que realmente necesitas.
Esa es la Descripción, la segunda de las cuatro prácticas en el Marco de Fluidez de IA de Anthropic Academy.
Es fácil subestimarla, porque una instrucción básica como "escribe un resumen" siempre producirá algo.
El problema es que algo plausible no es lo mismo que algo útil, y la brecha entre ambos es casi siempre una brecha de Descripción, no una limitación de Claude.
Esta página desglosa lo que contiene una descripción sólida y por qué cada pieza es importante.
Una descripción tiene tres componentes que importan más que cualquier otro.
El primero es el contexto: los hechos de fondo que Claude necesita pero que no puede saber por sí solo, como quién es la audiencia, qué sucedió antes de esta solicitud o en qué documento encaja esto.
El segundo son las restricciones: los límites explícitos para la salida, como la longitud, el tono, el formato, qué incluir y qué omitir.
El tercero es el objetivo real: no solo la tarea en sí, sino lo que el resultado necesita lograr una vez que exista, lo cual a menudo se deja sin decir porque parece obvio para la persona que pregunta.
Considera la diferencia entre "escribe un correo de seguimiento" y "escribe un correo de seguimiento para Priya, quien pidió una cotización revisada después de nuestra llamada del martes; mantenlo por debajo de 150 palabras y termina proponiendo una llamada esta semana".
La segunda versión proporciona los tres componentes en dos oraciones, y el borrador resultante necesita mucha menos corrección.
Una forma sencilla de pensarlo: una instrucción básica le dice a Claude qué hacer, mientras que una descripción completa le dice a Claude qué, para quién, dentro de qué límites y con qué fin.
La brecha entre esos es de donde provienen la mayoría de los primeros borradores decepcionantes.
La calidad de la descripción tiene un efecto mecánico directo en la práctica que le sigue.
Un prompt vago no limita nada, por lo que Claude tiene que elegir entre muchas interpretaciones plausibles, y la que elige puede no coincidir con lo que tenías en mente.
Esa discrepancia generalmente no se parece a un error obvio, se parece a un borrador que suena razonable pero que silenciosamente no da en el clavo, que es exactamente el tipo de resultado que requiere un Discernimiento cuidadoso para detectar.
Una descripción precisa limita el espacio de resultados plausibles antes de que Claude comience a escribir, lo que significa que hay menos que detectar y corregir después.
Es por eso que invertir tiempo en la Descripción tiende a ahorrar más tiempo del que cuesta: treinta segundos adicionales dedicados a indicar la audiencia y el objetivo pueden ahorrar varias rondas de "no es exactamente eso, inténtalo de nuevo".
Los ejemplos y las plantillas son una de las adiciones de mayor apalancamiento a una descripción.
Mostrarle a Claude una versión anterior de un documento similar, o una breve muestra del tono que deseas, comunica el formato y la voz de manera mucho más precisa que describirlos con palabras.
Débil: "Escribe una actualización de estado."
Mejor: "Escribe una actualización de estado. Usa la actualización de la semana pasada [adjunta]
como plantilla. Marca la integración de la API con 2 días de retraso;
la causa raíz es un sandbox retrasado del lado del proveedor."Aquí es también donde la conciencia de la ventana de contexto se convierte en una habilidad práctica de Descripción en lugar de un detalle técnico: decidir qué antecedentes son genuinamente cruciales para esta solicitud específica, en lugar de lo que solo añadiría ruido, es parte de escribir una buena descripción, no una preocupación separada.
La Descripción no escala linealmente con la complejidad de la tarea, escala con la ambigüedad.
Una tarea compleja pero bien entendida, como "formatea estas 50 filas en una tabla que coincida con este ejemplo", necesita muy poca descripción en prosa porque el ejemplo en sí mismo lleva la mayor parte de la especificación.
Una tarea de sonido simple pero ambigua, como "haz que esto suene mejor", necesita mucha más descripción, porque "mejor" podría significar más corto, más formal, más persuasivo, o una docena de otras cosas, y Claude no tiene forma de saber cuál quieres sin que se lo digan.
Es por eso que la habilidad de Descripción es realmente la habilidad de notar dónde reside realmente la ambigüedad en una solicitud, en lugar de agregar detalles en todas partes de manera uniforme.
La sobredescripción tiene costos reales.
Enterrar la única restricción que importa dentro de diez párrafos de antecedentes hace que sea fácil perderla, y exigir un control preciso sobre cada elección estilística menor puede producir resultados que suenen rígidos o sobre-diseñados en lugar de naturales.
La habilidad es especificidad proporcional: sé exacto sobre lo que realmente importa para esta tarea, y deja a Claude una latitud razonable sobre lo que no.
| Estilo de Descripción | Fortaleza | Debilidad | Mejor Ajuste |
|---|---|---|---|
| Instrucción básica | Rápido de escribir | Alta varianza, frecuentes repeticiones | Tareas triviales, de bajo riesgo, únicas |
| Contexto + restricciones | Salida predecible y acertada | Requiere más reflexión inicial | La mayoría de las tareas laborales reales |
| Contexto + restricciones + ejemplo/plantilla | Máxima fidelidad al formato y tono deseados | Requiere tener un buen ejemplo a mano | Documentos recurrentes, coincidencia con un estilo existente |
| Brief estructurado (objetivo, restricciones, antecedentes, criterios de éxito) | Maneja trabajo genuinamente complejo o ambiguo | Excesivo para tareas pequeñas | Proyectos de varios pasos, entregables de alto riesgo |
Para solicitudes genuinamente grandes o de varias partes, un brief estructurado que separa el objetivo, las restricciones, los antecedentes y los criterios de éxito en secciones distintas supera a un solo párrafo denso, ya que proporciona a Claude, y a un revisor humano, una lista de verificación clara para trabajar.
La práctica de darle a Claude suficiente contexto, restricciones explícitas y una declaración clara del objetivo real, para que pueda actuar sobre lo que realmente necesitas en lugar de adivinarlo.
Claude tiene que llenar los vacíos dejados por una solicitud vaga con suposiciones, y esas suposiciones frecuentemente no dan en el blanco de lo que la persona realmente quería, produciendo un borrador de apariencia plausible que silenciosamente no da en el clavo.
Un prompt vago amplía el rango de resultados plausibles, por lo que se debe detectar y corregir más durante la revisión; una descripción precisa limita ese rango de antemano, lo que hace que la revisión sea más rápida y confiable.
Un ejemplo comunica el formato, el tono y la estructura de manera más precisa que describirlos con palabras, a menudo ahorrando una ronda completa de revisión en comparación con una instrucción puramente basada en texto.
Sí. Enterrar la única restricción que importa dentro de un exceso de antecedentes puede hacer que sea fácil de pasar por alto, y especificar en exceso cada elección estilística menor puede producir resultados rígidos y sobre-diseñados; el objetivo es la especificidad proporcional, no la longitud máxima.
No. La Descripción escala con la ambigüedad, no con la complejidad; una tarea compleja pero bien entendida con un buen ejemplo necesita poca prosa, mientras que una solicitud simple pero ambigua necesita más explicación de lo que realmente quieres decir.
Es el juicio sobre qué información de fondo es genuinamente crucial para una solicitud específica versus qué solo añadiría ruido; decidir eso es una parte práctica de escribir una buena descripción, no una preocupación técnica separada.
Para solicitudes genuinamente grandes o de varias partes, dividir el objetivo, las restricciones, los antecedentes y los criterios de éxito en secciones distintas proporciona a Claude y a un revisor humano una lista de verificación más clara que un solo párrafo denso.
Trátalo como una señal sobre la descripción, no sobre la herramienta; identifica cuál de contexto, restricciones u objetivo faltaba o no estaba claro, y añade exactamente eso en el siguiente intento.
Está más cerca de ser un hábito continuo: la mayoría de las descripciones sólidas son el resultado de una rápida revisión después de ver dónde falló un primer intento, refinadas a través de un uso repetido en lugar de perfeccionadas en el primer intento.
La Delegación decide si y cuánto delegar; la Descripción solo importa una vez que se toma esa decisión, y una decisión de delegación bien definida generalmente necesita una descripción más corta y simple que una de alto riesgo o ambigua.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.
Revisado por Chris St. John·Última actualización: 16 jul 2026