Skills
Conhecimento empacotado em SKILL.md: onde ficam, como o agente escolhe, /skills.
Atualizado em 16 de set. de 2026
Uma skill é conhecimento empacotado: um SKILL.md com instruções, exemplos e, se quiser, scripts e referências ao lado. A diferença para as regras do projeto está no custo. O agente vê só o nome e a descrição de cada skill e carrega a que precisa, quando precisa, então uma biblioteca inteira de skills não pesa no contexto até ser usada.
---
name: checklist
description: Checklist de revisão antes de abrir um PR neste projeto. Use quando pedirem para revisar, preparar ou abrir um PR.
---
Antes de abrir um PR, confira:
1. os testes em tests/ passam;
2. funções novas têm docstring;
3. divisão por zero é tratada.
Responda com a lista e o status de cada item.A pasta tem o nome da skill e o arquivo se chama exatamente SKILL.md. Arquivos ao lado (scripts/, referencias/) podem ser citados no texto; o agente recebe o caminho da pasta ao carregar.
| Pasta | Vale para |
|---|---|
.hinow/skills/<nome>/SKILL.md | O projeto |
~/.config/hinow/skills/<nome>/SKILL.md | Todos os projetos |
~/.claude/skills/, ~/.agents/skills/ (e .claude/skills, .agents/skills no projeto) | Skills que você já tem de outras ferramentas; são lidas também |
skills.paths em hinow.json | Pastas extras: {"skills": {"paths": ["~/skills-da-empresa"]}} |
skills.urls | Um endereço que publica uma lista de skills (.well-known/skills) |
De três jeitos: o agente decide sozinho carregar a skill quando o pedido combina com a descrição; você digita /checklist e o texto dela vira o pedido; ou /skills abre a lista para escolher. hinow-cli debug skill mostra tudo que foi encontrado, com a origem.
A descrição decide
É pela description que o agente escolhe. Diga o que a skill faz e quando usá-la, com as palavras que a pessoa usaria no pedido ("PR", "revisar", "migração"). Skill sem descrição não aparece para o modelo.
customize-hinow é uma skill embutida que ensina o próprio agente a editar hinow.json, agentes, comandos, skills, MCP e plugins. Peça "crie um agente que…" ou "adicione um servidor MCP para…" e ele consulta essa skill antes de mexer nos arquivos.