skill-creator

Criador de Skills

Fluxo de Trabalho

1. Estabelecer o contrato.

   • Leia a skill existente e seus recursos, ou colete solicitações concretas para uma nova skill.
   • Separe ramificações reais do fluxo de trabalho de sinônimos para a mesma ramificação.
   • Concluído quando: cada ramificação tem um gatilho concreto, resultado esperado e destino de persistência.

2. Escolher a invocação.

   • Descoberta por modelo: escreva uma description voltada para o modelo; omita disable-model-invocation.
   • Apenas manual: defina disable-model-invocation: true; escreva um resumo voltado para humanos.
   • Comando de ferramenta direta: adicione command-dispatch: tool, command-tool e command-arg-mode apenas quando o comando ignora o modelo.
   • Concluído quando: o frontmatter corresponde a como a skill será realmente acessada.

3. Estruturar a skill.

   • Mapeie o procedimento ordenado compartilhado para SKILL.md; termine cada etapa com um critério de conclusão verificável e finalize com verificação.
   • Mantenha as condições de roteamento em description; inicie o corpo com a execução.
   • Mapeie detalhes específicos de ramificação para references/, helpers reutilizáveis para scripts/, recursos de saída para assets/ e metadados opcionais de IU para agents/.
   • Concluído quando: cada recurso planejado tem um propósito e um ponteiro direto a partir de SKILL.md.

4. Rascunhar e persistir.

   • Skill de workspace ativo: use skill_workshop para criar ou revisar uma proposta pendente; mantenha os arquivos ativos inalterados até aplicar.
   • Skill originada em repositório: use o fluxo de edição e revisão normal do repositório.
   • Concluído quando: a proposta ou diff de origem implementa cada ramificação da etapa 1 e contém cada recurso da etapa 3.

5. Validar.

   • Execute python {baseDir}/scripts/quick_validate.py <diretório-da-skill> e execute o teste focado de cada helper tocado.
   • Concluído quando: o frontmatter passa, os ponteiros de recurso resolvem e cada helper tocado passa em seu teste focado.

Frontmatter

Obrigatório: name, description.

OpenClaw também suporta metadata, homepage, license, allowed-tools, user-invocable, disable-model-invocation, command-dispatch, command-tool e command-arg-mode. Adicione campos opcionais apenas quando eles alteram o comportamento em tempo de execução ou a descoberta.