← Voltar ao curso
Nível 1 — Fundamentos · Módulo 1.5 — Skills: ensine seu jeito uma vez só

1.5.4 · Onde a skill vive e a biblioteca do time

3 min de vídeo TODOS

Objetivo: ao final, o consultor decide entre skill pessoal e de projeto, e sabe como contribuir para a biblioteca da consultoria.

O que você precisa levar desta aula

  1. Skill pessoal segue você; skill de projeto é versionada e herdada por quem clona.
  2. A decisão: é o seu jeito ou é o padrão do time?
  3. Para a biblioteca da casa: funcionou em pelo menos dois clientes.

As duas localizações

Pessoal De projeto
Caminho ~/.claude/skills/<nome>/SKILL.md .claude/skills/<nome>/SKILL.md na raiz do projeto
Windows C:\Users\<usuario>\.claude\skills\ idem, relativo à pasta do projeto
Quem usa Só você, em todos os projetos Todo mundo que tem a pasta do projeto
Versionada Não Sim, junto com o material do projeto
Serve para Seu jeito de trabalhar Padrão do time e do cliente

Como decidir

Skill Onde Por quê
Como você gosta que e-mails sejam redigidos Pessoal Preferência sua
Seu checklist de revisão de spec Pessoal, depois de projeto Começa como seu; quando o time adota, migra
Convenção de nomenclatura de objetos do cliente De projeto Vale para todos naquele cliente
Procedimento de cutover daquele projeto De projeto Todos precisam seguir igual
Template de spec da Wayon Biblioteca da casa Vale em todos os clientes
Padrão de análise de dump Pessoal, candidata à biblioteca Se funcionar em dois clientes, propõe

O caminho natural de uma skill

1. Você repete um procedimento duas vezes
      ↓
2. Escreve como skill PESSOAL
      ↓
3. Usa em um projeto, ajusta o que não funcionou
      ↓
4. Um colega precisa do mesmo → vira skill DE PROJETO
      ↓
5. Funcionou em dois clientes → propõe para a BIBLIOTECA

Não pule etapas. Skill que vai direto para a biblioteca sem ter sido usada tende a estar errada de um jeito que só o uso revela.

Contribuindo para a biblioteca

A biblioteca da Wayon fica em repositório GitHub privado. No Nível 3 ela vira o marketplace interno de plugins (módulo 3.3), então o que você publica agora não precisa ser refeito depois.

Critério de entrada - Usada em pelo menos dois clientes diferentes - Sem nada específico de cliente no conteúdo (nome, sigla, particularidade de customizing) - Descrição testada com o teste de 3 + 3 (aula 1.5.3) - Formato de saída explícito no corpo

Fluxo 1. Você limpa a skill do que era específico de cliente 2. Publica no repositório GitHub da biblioteca 3. Geovani revisa: a descrição dispara bem? O procedimento é verificável? É genérica de verdade? 4. Publicada, com dono e data de revisão

Manutenção - Toda skill na biblioteca tem um dono - Revisão a cada seis meses, ou quando o produto muda

Regra Wayon A biblioteca fica em repositório GitHub privado. Propõem: os consultores que fizeram este curso. Revisa e aprova a publicação: Geovani (geovani@nkodeai.com), engenheiro de AI da NkodeAI. Critério de entrada: usada em dois clientes, sem nada específico de cliente, descrição testada com o teste de 3 + 3. Toda skill publicada tem dono e data de revisão — sem dono, ela envelhece e ninguém percebe. Skill da biblioteca que não serve para um cliente: copie para o seu lado e ajuste. Não altere a da biblioteca para resolver um caso — isso quebra para todos os outros.

Por que existe revisor, e por que isso importa mais adiante: no módulo 3.3 esta biblioteca vira plugin, e plugin carrega hook, subagente e uma pasta bin/ que entra no PATH. A partir dali, publicar deixa de ser compartilhar texto e passa a ser distribuir código que roda na máquina dos colegas — e é por isso que a revisão do Geovani é o portão, não uma formalidade. A aula 3.3.3 mostra o que ele confere.

Uma nota sobre o Nível 2

Este módulo cobriu a skill de um arquivo. No módulo 2.4 você aprende a skill multi-arquivo — com reference.md para material extenso e scripts que a skill executa —, a skill de verificação (a que vale construir primeiro) e o troubleshooting de skill que não dispara.

📖 Compartilhando skills

Quiz — 4 questões

1.A convenção de nomenclatura de objetos Z do Meridiano, que todo mundo na squad precisa seguir.
  • a)Skill de projeto, versionada com o material do projeto

    Correto. Quem tem a pasta do projeto herda a convenção automaticamente.

  • b)Skill pessoal

    Só você seguiria a convenção. Os outros continuariam nomeando cada um do seu jeito.

  • c)Biblioteca da consultoria

    É específica de um cliente. Biblioteca é para o que vale em qualquer cliente.

Ver resposta e por quê
✅a) Correto. Quem tem a pasta do projeto herda a convenção automaticamente.
❌b) Só você seguiria a convenção. Os outros continuariam nomeando cada um do seu jeito.
❌c) É específica de um cliente. Biblioteca é para o que vale em qualquer cliente.
2.Como você gosta que o Claude redija seus e-mails: direto, sem preâmbulo, com o pedido de ação no último parágrafo.
  • a)Skill de projeto

    Você imporia o seu estilo de e-mail a todo mundo do projeto.

  • b)Instruções do Project

    Funcionaria dentro daquele Project, e você teria que repetir em cada um. Skill pessoal resolve de uma vez.

  • c)Skill pessoal

    Correto. É preferência sua e viaja com você em todos os projetos.

Ver resposta e por quê
❌a) Você imporia o seu estilo de e-mail a todo mundo do projeto.
❌b) Funcionaria dentro daquele Project, e você teria que repetir em cada um. Skill pessoal resolve de uma vez.
✅c) Correto. É preferência sua e viaja com você em todos os projetos.
3.Você escreveu uma skill de análise de short dump, usou uma vez no Meridiano e funcionou muito bem.
  • a)Mantenha como pessoal, use em outro cliente, e proponha se funcionar lá também

    Correto. O critério é ter funcionado em dois clientes diferentes.

  • b)Proponha imediatamente para a biblioteca da consultoria

    Um uso é uma hipótese. Skill que vai para a biblioteca sem rodagem tende a estar errada de um jeito que só o uso revela.

  • c)Deixe como skill de projeto do Meridiano

    Análise de dump não é específica do Meridiano. Como pessoal, ela já serve você em todos os clientes.

Ver resposta e por quê
✅a) Correto. O critério é ter funcionado em dois clientes diferentes.
❌b) Um uso é uma hipótese. Skill que vai para a biblioteca sem rodagem tende a estar errada de um jeito que só o uso revela.
❌c) Análise de dump não é específica do Meridiano. Como pessoal, ela já serve você em todos os clientes.
4.Antes de propor uma skill para a biblioteca da casa, o que é indispensável remover?
  • a)Os exemplos, para deixar mais enxuta

    Exemplos ajudam muito. Remova os que citam cliente, mas mantenha exemplos genéricos.

  • b)Tudo que é específico de um cliente: nomes, siglas, particularidades de customizing

    Correto. Skill de biblioteca precisa ser genérica de verdade, ou vai dar respostas erradas no cliente seguinte.

  • c)A descrição, que cada consultor deveria escrever a sua

    A descrição é o gatilho. Sem ela a skill não dispara para ninguém.

Ver resposta e por quê
❌a) Exemplos ajudam muito. Remova os que citam cliente, mas mantenha exemplos genéricos.
✅b) Correto. Skill de biblioteca precisa ser genérica de verdade, ou vai dar respostas erradas no cliente seguinte.
❌c) A descrição é o gatilho. Sem ela a skill não dispara para ninguém.