Não trate o hub ou uma companheira como a ferramenta de trabalho.

O hub lista packs. Uma página companheira é Setup: copiar ou baixar. Nenhuma desenha um wireframe, executa uma auditoria ou tira capturas de breakpoints. Para esses trabalhos, abra a ferramenta correspondente no navegador ou deixe a skill instalada rodar no seu agente.

Não instale uma vez e baixe a mesma skill como um segundo fluxo.

Execute npx skills@latest add iruhdam1/skills ou baixe um pack da companheira — não os dois para a mesma skill. Duas cópias divergem; o agente pode carregar a desatualizada.

Não escreva descrições na primeira pessoa ou vagas.

Claude e outros hosts descobrem skills pelo campo description. Primeira pessoa (“Eu ajudo você…”) ou escopo vazio significa que o agente nunca escolhe o arquivo. Escreva o que ela faz e quando usá-la, na terceira pessoa. As notas de autoria da Anthropic cobrem a mesma regra.

Não encha o SKILL.md com tudo.

Mantenha o corpo como um procedimento. Coloque notas longas um nível abaixo em um arquivo de referência irmão para os hosts carregá-las só quando preciso. Um muro de texto queima contexto e esconde o gatilho.

Não copie .agents/skills da loja nem edite o Analog.

A pasta .agents/skills desta loja (COSS, Phosphor e outros auxiliares do agente) não é o pack público. Não a copie. Não edite o Analog. O conjunto público é o pack do GitHub listado no hub.

Não persiga um listing ausente no skills.sh.

skills.sh é uma listagem pública mais telemetria de instalação. Um badge ausente não é um push falho no GitHub. Use o GitHub ou a companheira da loja se um pack ainda não estiver listado. Veja skills.sh vs GitHub.