Sua skill não funciona: comece pelo sintoma

Question 1

A skill nunca ativa, nem na tarefa para a qual foi escrita.

Accepted Answer

A descrição está escrita no vocabulário do autor, então não bate com o jeito que o pedido é feito. Reescreva a descrição com as palavras que um colega usaria e inclua a parte quando de forma explícita. Teste pedindo a tarefa com a formulação de outra pessoa, não a sua.

Question 2

Ela ativa em tarefas com que não tem nada a ver.

Accepted Answer

A descrição é ampla ou genérica, então bate com muito mais do que deveria. Estreite a descrição para o artefato ou a situação específicos. Cite o formato, o sistema ou o tipo de documento em vez da atividade geral.

Question 3

Ela carrega, mas o agente segue só a primeira parte.

Accepted Answer

O corpo é longo e as instruções que importam ficam enterradas atrás de contexto que o modelo não precisa. Corte o contexto. Mova o detalhe para references/ e deixe no corpo procedimento, pontos de decisão e formato do resultado.

Question 4

O comportamento muda entre sessões sem você mudar nada.

Accepted Answer

Outra skill instalada instrui o agente sobre a mesma decisão, e qual delas vence não é estável. Consulte o mapa de compatibilidade e remova uma das duas. Duas metodologias para um trabalho é conflito, não redundância.

Question 5

As sessões ficaram mais pesadas depois que você instalou um conjunto de skills.

Accepted Answer

Cada skill instalada paga os metadados no início, e corpos enormes pagam de novo ao ativar. Apague as skills que ninguém dispara e divida as que passam de umas 500 linhas. O custo é por sessão, então acumula.

Question 6

Funciona para você e não para um colega.

Accepted Answer

Ou a skill não está instalada do lado dele, ou ela depende de algo do seu ambiente que a skill nunca declara. Declare os requisitos reais de ambiente em compatibility e verifique se a skill assume ferramentas, caminhos ou credenciais que só você tem.

Question 7

O validador passa mas não acontece absolutamente nada.

Accepted Answer

A validação confere o arquivo, não a instalação. O nome da pasta pode não bater com o campo name, ou a skill pode não estar onde o agente carrega. Confirme que a pasta tem exatamente o mesmo nome do campo name e depois que a skill está instalada onde o seu agente lê skills.

Sua skill não funciona: comece pelo sintoma

Por que tudo isso falha em silêncio

A ordem para checar

Sintoma	Causa mais provável	O que mudar
A skill nunca ativa, nem na tarefa para a qual foi escrita.	A descrição está escrita no vocabulário do autor, então não bate com o jeito que o pedido é feito.	Reescreva a descrição com as palavras que um colega usaria e inclua a parte quando de forma explícita. Teste pedindo a tarefa com a formulação de outra pessoa, não a sua.
Ela ativa em tarefas com que não tem nada a ver.	A descrição é ampla ou genérica, então bate com muito mais do que deveria.	Estreite a descrição para o artefato ou a situação específicos. Cite o formato, o sistema ou o tipo de documento em vez da atividade geral.
Ela carrega, mas o agente segue só a primeira parte.	O corpo é longo e as instruções que importam ficam enterradas atrás de contexto que o modelo não precisa.	Corte o contexto. Mova o detalhe para references/ e deixe no corpo procedimento, pontos de decisão e formato do resultado.
O comportamento muda entre sessões sem você mudar nada.	Outra skill instalada instrui o agente sobre a mesma decisão, e qual delas vence não é estável.	Consulte o mapa de compatibilidade e remova uma das duas. Duas metodologias para um trabalho é conflito, não redundância.
As sessões ficaram mais pesadas depois que você instalou um conjunto de skills.	Cada skill instalada paga os metadados no início, e corpos enormes pagam de novo ao ativar.	Apague as skills que ninguém dispara e divida as que passam de umas 500 linhas. O custo é por sessão, então acumula.
Funciona para você e não para um colega.	Ou a skill não está instalada do lado dele, ou ela depende de algo do seu ambiente que a skill nunca declara.	Declare os requisitos reais de ambiente em compatibility e verifique se a skill assume ferramentas, caminhos ou credenciais que só você tem.
O validador passa mas não acontece absolutamente nada.	A validação confere o arquivo, não a instalação. O nome da pasta pode não bater com o campo name, ou a skill pode não estar onde o agente carrega.	Confirme que a pasta tem exatamente o mesmo nome do campo name e depois que a skill está instalada onde o seu agente lê skills.