Encontre a pasta instalada; edite o SKILL.md.

Abra o diretório da skill no disco e edite o SKILL.md. Esse é o arquivo que os hosts carregam. Mantenha o nome da pasta e o name do frontmatter alinhados quando o host exigir correspondência (Cursor e VS Code dizem que o nome deve coincidir com a pasta pai).

Descrição na terceira pessoa: o que faz e quando usar.

Os campos obrigatórios no padrão aberto são name e description. A descrição é como o agente descobre a skill. Terceira pessoa, gatilhos concretos, sem voz de ajudante na primeira pessoa.

Mantenha o corpo como um procedimento.

Escreva passos que o agente possa seguir. Mova notas longas para um arquivo de referência irmão um nível abaixo e vincule-o no corpo para o carregamento progressivo continuar funcionando.

Reinsira /skill-name ou um prompt correspondente.

No Claude, digite /skill-name. No Cursor, / e o nome da skill. No Codex, /skills ou $ para mencioná-la. Ou peça em linguagem simples usando as mesmas palavras-gatilho da descrição.

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

Deixe o Analog e o .agents/skills interno desta loja em paz. Esses não são o pack público. Veja How not to use portable skills.