5 de noviembre de 2026

Tu agente de IA sigue tus habilidades. ¿Quién revisa las instrucciones?

Tu agente de IA sigue tus habilidades. ¿Quién revisa las instrucciones?

Un agente de programación puede seguir una habilidad al pie de la letra y aun así recibir una tarea poco clara.

La descripción puede ser demasiado vaga para explicar cuándo esa habilidad corresponde a una tarea. El procedimiento puede pedir un comando sin limitar su salida. Una copia antigua puede contener instrucciones que ya no coinciden con la versión que utilizas en otros lugares.

Esos son problemas de las instrucciones que das al agente. Merecen una revisión por sí solos.

Skillwright ofrece un punto de partida para esa revisión. Es una aplicación de escritorio para Windows que analiza los archivos de habilidades de agentes de IA de tu equipo, explica lo que encuentra y genera indicaciones concretas de corrección que puedes llevar a tu agente de programación.

Los pequeños archivos detrás de un flujo de trabajo más amplio

Una habilidad de agente agrupa instrucciones y recursos de apoyo en torno a un archivo SKILL.md. La documentación de Agent Skills describe un proceso de divulgación progresiva: los nombres y las descripciones ayudan al agente a descubrir habilidades relevantes, mientras que las instrucciones más completas se cargan cuando son necesarias.

Esto somete a presión dos tipos de redacción. La descripción tiene que explicar cuándo resulta útil una habilidad. El cuerpo tiene que ofrecer al agente indicaciones suficientes para completar el trabajo sin llenar el contexto con material innecesario.

Una habilidad que se lee bien a ojos de su autor puede dejar aún sin responder preguntas prácticas:

  • ¿Qué tarea debería activar esta habilidad?
  • ¿Qué trabajo queda fuera de su alcance?
  • ¿Cuánta salida de un comando debería recopilar el agente?
  • ¿Qué pruebas le indican que el trabajo está completo?
  • ¿Cómo debería ser el resultado final?

A medida que crece una biblioteca de habilidades, revisar esas preguntas archivo por archivo se convierte en otra tarea de mantenimiento. Skillwright reúne los hallazgos en una sola vista.

Identifica lo que necesita atención, con pruebas

Skillwright detecta carpetas de habilidades para Claude Code, Codex, Cursor y Kilo Code. También puedes seleccionar una carpeta personalizada que contenga archivos SKILL.md.

Comprueba si existen problemas como un preámbulo con un formato incorrecto, descripciones ausentes y nombres de habilidades duplicados. También examina cómo describen las instrucciones los desencadenantes, el alcance, los procedimientos y los límites de salida.

Cada habilidad recibe calificaciones independientes de A–D para la alineación con AXI y la ingeniería de contexto. La alineación con AXI examina los metadatos, las descripciones de los desencadenantes, la superficie siempre activa y la divulgación progresiva. La ingeniería de contexto examina cómo gestiona el cuerpo el contexto, incluidos la salida delimitada, los procedimientos, los criterios de salida y el formato del resultado.

La parte útil son las pruebas que respaldan una calificación. Puedes inspeccionar el criterio, leer el hallazgo y decidir si el cambio sugerido encaja en tu flujo de trabajo.

Estas calificaciones son heurísticas explícitas. No constituyen una medida objetiva de la calidad de una habilidad, una certificación de seguridad ni una predicción del comportamiento de todos los agentes.

Convierte un hallazgo en una edición que puedes revisar

Un informe resulta más útil cuando te ayuda a dar el siguiente paso.

Para los hallazgos concretos, Skillwright produce indicaciones de corrección basadas en plantillas. Copia una indicación en tu agente de programación, revisa la edición propuesta, aplica los cambios que quieras y vuelve a analizar.

Por ejemplo, un hallazgo sobre los límites de salida te ofrece un problema concreto que debes abordar en una habilidad que invoca un comando. Puedes pedir a tu agente que revise esa instrucción y comprobar después que el nuevo límite sigue ofreciendo al flujo de trabajo información suficiente para finalizar.

La decisión de editar permanece en tus manos. Skillwright no reescribe automáticamente tus habilidades, y las sugerencias se etiquetan por separado de los hallazgos que reciben indicaciones de corrección.

Haz visible el coste adicional del contexto

Skillwright también muestra estimaciones del número de tokens de las descripciones y del cuerpo, incluido el coste siempre activo de la lista de habilidades.

Esto te ofrece una forma práctica de revisar dónde debe estar cada información. Una descripción breve puede identificar la tarea. Unas instrucciones detalladas pueden explicar el procedimiento. Los archivos de referencia pueden contener material que solo sea necesario en casos concretos.

Las estimaciones utilizan los caracteres divididos entre cuatro. Considéralas una ayuda de comparación, no recuentos exactos de facturación del modelo ni una promesa de costes menores. Eliminar texto solo resulta útil cuando las instrucciones restantes siguen explicando el trabajo.

Análisis local, con límites claros

Los archivos de habilidades pueden contener procedimientos internos o detalles de proyectos. Skillwright los lee y analiza localmente. No realiza llamadas a modelos de lenguaje ni carga los archivos para analizarlos. La aplicación no requiere una cuenta y no incluye telemetría.

Microsoft Store utiliza la red para comprobar la licencia de prueba o de compra. Si decides enviar una solicitud de soporte, la aplicación envía el mensaje que has introducido y los datos de la aplicación o el dispositivo que se muestran, junto con una referencia de la solicitud y un identificador de producto. No adjunta archivos de habilidades, rutas ni resultados del análisis. La política de privacidad explica estos límites.

Empieza por una habilidad que ya utilices

No necesitas reconstruir tu biblioteca para probar un proceso de revisión más deliberado.

Empieza por una habilidad que utilices con regularidad. Ejecuta un análisis, inspecciona las pruebas y elige un hallazgo que merezca la pena corregir. Lleva su indicación a tu agente de programación, revisa la edición y vuelve a analizar. Después, prueba la habilidad revisada en el flujo de trabajo que pretende respaldar.

El análisis puede identificar problemas en las instrucciones. Tu flujo de trabajo proporciona la prueba final de si las instrucciones revisadas resultan útiles.

Skillwright está disponible para Windows con una prueba gratuita de 7 días y una compra única por 19,99 USD como precio de referencia. No hay suscripción. Microsoft Store determina el precio regional final, la moneda, los impuestos y las condiciones de compra. Finalizada la prueba, el análisis requiere una compra; los informes existentes siguen siendo consultables.

Inicia tu prueba gratuita de 7 días en Microsoft Store o Mira la demostración del producto.

Dale a las instrucciones de tu próxima sesión una revisión por sí sola.