pedido-claro
Skill2 starsChanged 5 months agoMITView on GitHub
Puente de entendimiento por pedido: antes de ejecutar un pedido ambiguo, refleja en una frase qué entendiste, pasa el texto por `spec_lint` si es un requisito, y haz solo las preguntas que cambian el resultado. Al cerrar, si el pedido era vago, ofrece una versión mejor formulada para la próxima vez. Es el hermano por-pedido de `discovery-intake` (que cubre el proyecto entero).
In this repository25 other files it gives its agents.
- accessibility-wcagSkill
- agent-orchestrationSkill
- backend-api-designSkill
- backend-data-modelingSkill
- backend-observabilitySkill
- backend-performanceSkill
- blossom-carouselSkill
- browser-qaSkill
- commit-hygieneSkill
- discovery-intakeSkill
- frontend-component-patternsSkill
- geo-seoSkill
- gh-cliSkill
- glosario-vivoSkill
- llm-councilSkill
- ponytailSkill
- reporte-comprensibleSkill
- sdd-flowSkill
- secure-by-defaultSkill
- security-authn-authzSkill
- security-owaspSkill
- security-secretsSkill
- security-supply-chainSkill
- turtle-protocolSkill
- ui-ux-pro-maxSkill
The file
Files
Pedido claro — entiende antes de ejecutar
Cuándo aplica
En cada pedido de la persona que admita más de una interpretación razonable, o que pida construir/cambiar algo sin criterios verificables. Si el pedido es inequívoco y chico, ejecuta directo: esta skill no agrega burocracia a lo trivial.
El reflejo (una frase, siempre que haya ambigüedad)
Antes de ejecutar, di con tus palabras qué entendiste y qué vas a hacer:
"Entiendo que quieres X para lograr Y; voy a hacerlo con Z."
Esto le da a la persona la oportunidad de corregirte ANTES de que gastes trabajo en la interpretación equivocada. Una frase basta; no repitas el pedido entero.
La caza de ambigüedad (si el pedido define requisitos)
Si el pedido describe algo a construir ("quiero que sea rápido", "debe manejar los pagos"), pásalo por el tool spec_lint. Por cada término que devuelva, decide:
- Si la respuesta cambia lo que vas a construir → pregunta (máximo 2-3 preguntas, las de mayor impacto).
- Si puedes asumir un valor razonable → asume, dilo explícito ("asumo p95 < 500 ms; corrígeme si no") y sigue.
Nunca hagas una lista larga de preguntas: elige las que bifurcan el diseño.
El registro (cierra el circuito)
Cuando la interpretación quedó acordada, guárdala con memory_save (tipo note, topic_key: pedido/<área>): el pedido original, la interpretación acordada y las suposiciones declaradas. Así la próxima sesión no rediscute lo mismo.
El espejo (mejora los pedidos futuros)
Al terminar un trabajo cuyo pedido fue ambiguo, ofrece —en una línea, sin sermonear— cómo se podría haber pedido para llegar directo:
"Para la próxima: «agrega login con Google, sesión de 24 h, sin registro propio» me habría llevado directo."
La persona aprende a pedir mejor; el agente aprende a entender mejor. Ese es el objetivo de esta skill.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

