Preguntas

¿Cómo se comprueba si una skill funciona de verdad?

Comprueba dos cosas por separado: si la skill se activa con las peticiones que debe y si su resultado es el que querías. Ejecuta unas cuantas peticiones realistas en una sesión nueva con la skill disponible, luego otra vez con ella desactivada, y compara. Que se active solo demuestra que se encontró, no que haya servido.

Empieza por una línea base, no por un borrador

La guía de autoría de Anthropic pide crear evaluaciones antes de escribir documentación extensa. Ejecuta Claude en tareas representativas sin la skill y anota dónde falla, construye tres escenarios sobre esas carencias, mide la línea base y escribe solo las instrucciones necesarias para cubrirlas. Así la skill apunta a fallos que viste y no a fallos imaginados, y queda una línea base para cada cambio posterior.

Usa una sesión nueva y desactiva la skill en la segunda ejecución

La sesión tiene que ser nueva porque el contexto que queda de escribir la skill tapa los huecos de lo escrito. En Claude Code, pon una skill personal o de proyecto en "off" en skillOverrides para la segunda ejecución; las de un plugin se comparan con claude plugin eval. El plugin skill-creator automatiza el ciclo: guarda los casos de prueba en evals/evals.json, ejecuta cada uno en su propio subagente y califica el resultado.

Prueba en cada modelo y observa cómo la lee Claude

Una skill se suma a un modelo, así que la guía pide probarla en cada modelo con el que piensas usarla: si a Haiku le da orientación suficiente y si a Opus le explica más de lo que necesita. Después observa cómo recorre Claude la skill. Un archivo incluido que nunca abre puede sobrar o estar mal señalado, y uno que lee siempre quizá deba ir en el propio SKILL.md.