RECURSOS · INTELIGENCIA ARTIFICIAL

Revisa tus skills con criterio

Un prompt para detectar instrucciones repetidas, mejorar la carga de contexto y conservar lo que protege tu proyecto.

Para GPT-6 Astra, Claude Fable 5.1 y otros agentes · Por Santi Scagliusi

Primero audita. Después decide.

Copia el prompt y pégalo en tu agente dentro del proyecto que quieres revisar. Te propondrá cambios con rutas y ejemplos antes de modificar archivos.

Lee el prompt completo

Puedes revisarlo aquí antes de copiarlo o descargarlo.

Quiero revisar y simplificar las skills y las instrucciones que utiliza mi agente en este proyecto. El objetivo es conservar el contexto útil y las garantías reales, reduciendo duplicados, contradicciones y pasos que no aportan. No busco alcanzar un número arbitrario de skills ni de líneas.

Empieza con una auditoría de solo lectura. Comprueba el estado del proyecto y conserva los cambios ajenos. Localiza las instrucciones que realmente se aplican, como AGENTS.md o CLAUDE.md, sus archivos equivalentes o anidados y las skills locales y globales disponibles. Distingue archivos instalados, enlaces, copias y contenido gestionado por plugins. Si no tienes acceso a una parte, dilo y pide solo lo necesario para revisarla.

Aplica estos criterios:

• Selección de skills. Sus nombres y descripciones deben permitir elegirlas sin cargar instrucciones innecesarias. Busca nombres repetidos, descripciones demasiado amplias y varias skills que compiten por la misma tarea. No supongas que el contenido completo de todas las skills se carga siempre ni que tener muchas demuestra por sí solo un problema. Distingue lo que observas de lo que infieres sobre el catálogo del agente.

• Descripciones. Propón textos breves que expliquen cuándo usar cada skill. Evita listas de palabras clave y reglas del tipo «úsala siempre» que atraigan trabajo ajeno a su propósito.

• Carga progresiva. Mantén en SKILL.md el propósito, las restricciones necesarias y las rutas. Lleva procedimientos largos o condicionales a referencias que se lean cuando hagan falta. Conserva scripts, recursos, licencias y dependencias.

• Instrucciones del proyecto. Conserva conocimiento específico que cambie decisiones. Sustituye lecturas obligatorias de todo el repositorio por referencias según la tarea. Detecta reglas repetidas, documentación desactualizada y recetas que limiten el criterio sin proteger un riesgo concreto.

• Verificación y autonomía. Conserva comprobaciones de seguridad, integridad y comportamiento. Ajusta las pruebas al cambio y evita repetir baterías sin motivo. Expresa qué trabajo local autorizado puede continuar sin preguntar cada vez. No afirmes que una prueba usa datos desechables o carece de acceso a producción sin comprobarlo.

• Finalización. Define el resultado observable: implementar, ejecutar lo pertinente, inspeccionar el resultado y corregir los fallos atribuibles al cambio. No añadas una parada tras la primera versión si la tarea requiere completarla. Mantén claros el alcance y las acciones externas que necesitan autorización.

• Ámbito y modelos. Una skill especializada puede pertenecer a determinados proyectos en lugar de ser global. Comprueba quién la utiliza antes de moverla. Si otros agentes o modelos trabajan en el repositorio, no optimices sus instrucciones exclusivamente para uno.

Devuelve primero los hallazgos con rutas y ejemplos, su efecto probable y una propuesta concreta de qué conservar, simplificar, consolidar, mover o retirar. Incluye las nuevas descripciones y el borrador de las instrucciones principales. No inventes porcentajes de mejora. Pregunta únicamente por usos o decisiones que no puedas determinar y que cambien la propuesta. Espera mi aprobación antes de modificar archivos.

Cuando apruebe la propuesta, ejecuta los cambios autorizados de forma reversible, conserva las variantes que puedan ser necesarias y comprueba que los enlaces, recursos y consumidores siguen funcionando. No edites cachés de plugins ni borres una skill compartida sin resolver su gestión y dependencias. No publiques, despliegues, envíes mensajes ni hagas push por esta auditoría. Termina con un resumen de cambios, evidencia, límites y estado de los archivos.

Llévatelo en el formato que prefieras

Descargar PDFPara leer y guardar Descargar WordDocumento editable Descargar TXTSolo el texto

El prompt pide conservar scripts, recursos y comprobaciones útiles. Revisa la propuesta antes de aprobar cambios: simplificar instrucciones exige conocer cómo se utilizan.

Más sobre mi trabajo