Escribe el cuándo, no solo el qué
La especificación pide que la descripción diga qué hace la skill y cuándo usarla, con palabras clave que un agente pueda comparar contra una tarea. Compara una descripción que suena a título con otra que nombra el disparador: tipos de archivo, nombres de herramientas, las palabras que usaría una persona al pedir ese trabajo. La segunda es comparable; la primera es decoración.
Revisa antes el nombre y el directorio
Antes de reescribir nada, confirma que el name del frontmatter coincide exactamente con el directorio padre y que respeta el formato: de 1 a 64 caracteres, minúsculas, dígitos y guiones, sin guion inicial, final ni repetido. Un desajuste aquí produce exactamente el mismo síntoma que una mala descripción, que es el silencio.
Después busca una vecina que ya reclamó la tarea
Si dos skills instaladas describen territorios que se solapan, una ganará casi siempre y la otra parecerá rota. Estrecha las descripciones hasta que cada una nombre un disparador distinto, o fusiónalas. Conviene comprobarlo antes de concluir que el formato no es fiable.