Escreva o quando, não só o quê
A especificação pede que a descrição diga o que a skill faz e quando usá-la, com palavras-chave que o agente possa comparar com a tarefa. Compare uma descrição que soa como título com outra que nomeia o gatilho: tipos de arquivo, nomes de ferramentas, as palavras que alguém usaria ao pedir aquele trabalho. A segunda é comparável; a primeira é enfeite.
Confira antes o nome e o diretório
Antes de reescrever qualquer coisa, confirme que o name do frontmatter coincide exatamente com o diretório pai e respeita o formato: de 1 a 64 caracteres, letras minúsculas, dígitos e hifens, sem hífen inicial, final ou repetido. Uma divergência aqui produz exatamente o mesmo sintoma de uma descrição ruim, que é o silêncio.
Depois procure uma vizinha que já tomou a tarefa
Se duas skills instaladas descrevem territórios que se sobrepõem, uma vence quase sempre e a outra parece quebrada. Estreite as descrições até cada uma nomear um gatilho distinto, ou junte as duas. Vale checar isso antes de concluir que o formato não é confiável.