Nova Skill Creator — Skill Engineer Protocol v2.2
Versão 2.4.1 · Padrão: Fluxo de Trabalho Sequencial · Tipo: Code Scaffolding & Templates
"Skill Engineer Protocol v2.2" é o nome do processo que esta skill segue, não o número da versão.
Propósito
Esta meta-skill transforma toda solicitação relacionada a skills (escrever nova / atualizar / editar / revisar) em um processo de engenharia padrão e produz uma skill profissional que pode ser implantada imediatamente. Cada skill de saída é um "funcionário virtual" autônomo: 1 arquivo SKILL.md ou 1 pasta completa, dependendo da complexidade e do ambiente alvo.
Quando esta skill for ativada, inicie a resposta exatamente com esta frase: "Skill Engineer Protocol v2.2 ativado. Iniciando o processo padrão..."
Após essa frase, responda no idioma em que o usuário escreve.
⚠️ Preservar conteúdo ao reescrever (REGRA SUPREMA)
"Reescrever completamente" significa reestruturar, NÃO comprimir/resumir. Quando esta skill é aplicada com outro LLM (especialmente um modelo mais fraco), a falha mais comum é que descrições técnicas são comprimidas, colunas de tabelas são cortadas e esquemas/valores concretos são descartados — a saída parece mais organizada, mas perdeu conteúdo original.
Distinção obrigatória:
| Reestruturar (CORRETO) | Comprimir (ERRADO) |
|---|---|
| Alterar layout, mesclar seções duplicadas, corrigir redação | Remover tabelas, linhas, colunas, exemplos |
| Manter cada valor/esquema/ID/regra exatamente como estão | Parafrasear um esquema como "aproximadamente" |
| Número de itens de saída >= número de itens de entrada | Reduzir de 10 problemas para 4 |
| Aumentar clareza | Reduzir detalhes "para encurtar" |
Processo anti-compressão de 3 etapas — OBRIGATÓRIO antes/depois de cada reescrita ou atualização:
- Inventário primeiro (Content Inventory): liste cada elemento original que NÃO deve ser perdido — cada tabela (com sua contagem de linhas/colunas), cada regra de esquema, cada valor concreto (ID, versão, opção), cada problema, cada caso de teste. Escreva como uma lista de verificação.
- Reescrita com restrições: durante a reescrita, cada elemento da lista deve aparecer completo na saída. Você pode melhorar a apresentação; NÃO pode reduzir o número de elementos ou o detalhamento de qualquer elemento.
- Verificação posterior (Diff Check): compare a saída com o inventário. Se algum elemento estiver faltando, ou uma tabela tiver menos linhas/colunas que o original → NÃO CONCLUÍDO; restaure antes de responder.
Instrução de auto-vinculação para o LLM executor: "Preserve textualmente toda tabela, esquema, valor concreto e problema. Não resuma, não remova detalhes técnicos. Se precisar ser mais curto, DIVIDA em referências/; nunca DELETE conteúdo."
Uma skill é uma pasta — escolha a estrutura pela complexidade
Claude, Claude Code e outros agentes suportam skills como uma pasta com SKILL.md + recursos agrupados, com Divulgação Progressiva (recursos carregados sob demanda), scripts executáveis offline e references/ carregadas dinamicamente. Você não precisa colocar tudo em 1 arquivo.
| Complexidade | Estrutura recomendada |
|---|---|
| Skill simples e curta | Apenas 1 arquivo SKILL.md (ainda válido) |
| Skill com lógica repetitiva/determinística | Pasta + scripts/ |
| Skill multi-domínio / documentação longa | Pasta + references/ dividida por variante |
| Skill que gera arquivos agrupados (modelos/ícones/fontes) | Pasta + assets/ |
Princípio: escolha a menor estrutura que seja suficiente. Simples → 1 arquivo; complexo → dividir em uma pasta para manter SKILL.md enxuto. Quando o conteúdo for muito longo → DIVIDA em references/, NÃO o comprima.
Anatomia de uma Skill
nome-da-skill-em-kebab-case/
├── SKILL.md (obrigatório)
│ ├── Frontmatter YAML (5 campos para contas/LLMs de formulário livre · APENAS nome + descrição para Skills de Agente Padrão — veja 'Variantes por AMBIENTE ALVO')
│ └── Instruções em Markdown
└── Recursos agrupados (opcional)
├── scripts/ - Código executável para tarefas determinísticas/repetitivas
├── references/ - Documentos carregados no contexto quando necessário
└── assets/ - Arquivos usados na saída (modelo, ícone, fonte)
Divulgação Progressiva (3 níveis de carregamento)
| Nível | Conteúdo | Quando entra no contexto |
|---|---|---|
| 1 | Metadados (name + description) | Sempre (~100 palavras) |
| 2 | Corpo do SKILL.md | Quando a skill é ativada (idealmente abaixo de 500 linhas) |
| 3 | Recursos agrupados | Quando necessário (references/ carregam dinamicamente; scripts/ executam sem carregar seu conteúdo no contexto) |
Regra: mantenha o corpo do SKILL.md abaixo de 500 linhas. Quando se aproximar do limite → divida em references/ e deixe um ponteiro claro no SKILL.md indicando onde ler. Uma referência longa (>300 linhas) deve ter um sumário. Dividir é DIFERENTE de comprimir — dividir mantém o conteúdo intacto em outro arquivo, comprimir perde conteúdo.
Processo de ESCREVER UMA NOVA SKILL (8 etapas)
| # | Etapa | Descrição |
|---|---|---|
| 1 | Perguntar por informações faltantes | Objetivo, problemas, idioma, saída, ambiente alvo. Se a conversa já contém o fluxo → extraia do histórico primeiro, pergunte apenas o que está faltando |
| 2 | Escolher 1 Padrão + 1 Tipo de Skill | Exatamente 1 de cada (veja as listas abaixo) |
| 3 | Escrever a Descrição PRIMEIRO | A etapa mais importante — siga o Protocolo de Descrição abaixo |
| 4 | Escolher a estrutura + projetar o conteúdo | Arquivo único ou pasta? O que fica inline, o que vai para references/, qual lógica se torna scripts/ |
| 5 | Escrever SKILL.md | YAML + Fluxo de Trabalho + Regras/Esquemas + Problemas; corpo abaixo de 500 linhas, transfira partes longas para referências |
| 6 | Escrever scripts/references (se necessário) | Lógica determinística/repetitiva → scripts/; documentação longa → references/ com ponteiros |
| 7 | Testar ativação | 3 casos positivos + 3 negativos |
| 8 | Responder usando o Formato de Saída | Veja a seção de Formato de Saída abaixo |
LIBERE APENAS quando todos os 14/14 itens da Lista de Verificação passarem.
Processo de ATUALIZAR / EDITAR (8 etapas)
- Leia todo o SKILL.md atual (e seus arquivos agrupados).
- Inventário primeiro — liste cada tabela/esquema/valor/problema/caso de teste que NÃO deve ser perdido (regra suprema, etapa 1).
- Registre problemas do usuário e de execuções anteriores.
- Avalie contra a Lista de Verificação de 14 itens.
- Identifique o tipo de falha: Sub-ativação / Super-ativação / Erro de execução / Perda de conteúdo (compressão/truncamento).
- Reescreva tudo sob a restrição de preservação — reestruture, NÃO comprima. NUNCA corrija pedaço por pedaço.
- Verifique depois — compare a saída com o inventário, restaure qualquer coisa faltando.
- Re-teste 3 casos positivos + 3 negativos, aumente a
version.
Regra de ferro: Reescrever completamente = reestruturar mantendo todo o conteúdo. Sem remendos. Sem comprimir detalhes. Mantenha o name antigo ao atualizar.
Frontmatter YAML (OBRIGATÓRIO)
---
name: nome-da-skill-em-kebab-case
version: x.x.x
description: >-
[Descrição otimizada para ativação, abaixo de 1024 caracteres, ASCII simples sem diacríticos, sem colchetes angulares]
pattern: [1 dos 5 Padrões]
type: [1 dos 9 Tipos de Skill]
---
Variantes por AMBIENTE ALVO (pergunte antes de escrever o frontmatter)
O bloco de 5 campos acima é o modelo para contas claude.ai / Grok / LLMs de formulário livre. Alguns alvos aceitam exatamente 2 campos — enviar a versão de 5 campos lá falha na validação imediatamente, antes mesmo da revisão começar. A etapa 1 (coleta) DEVE perguntar ou inferir o alvo; se não estiver claro, use a versão de 2 campos por padrão, porque a versão de 2 campos funciona em todos os alvos enquanto a de 5 campos não.
| Alvo | Frontmatter | Onde Version / Pattern / Type vão |
|---|---|---|
| Conta claude.ai, Grok, outros LLMs | 5 campos como no modelo acima, description dobrado >- | no YAML |
Skills de Agente Padrão (Claude Code .claude/skills, Codex .agents/skills) e registros de skills com validação estrita | APENAS name + description, cada um em UMA linha — sem >-, sem linhas indentadas, sem terceiro campo | uma linha de blockquote logo abaixo do H1: > **Versão x.y.z** · Padrão: … · Tipo: …; a versão real vive no arquivo de registro/manifesto do sistema alvo (se houver) |
Modelo para alvos de Skills de Agente:
---
name: nome-da-skill-em-kebab-case
description: "[Descrição otimizada para ativação, UMA linha, >= 40 caracteres, ASCII simples sem diacríticos, sem colchetes angulares]"
---
Sempre coloque uma description de uma linha entre aspas duplas. Claude Code e Codex leem o frontmatter com um parser YAML real. Com um valor puro, há dois tipos de problema. (1) Erro de parse — a skill carrega com metadados vazios e sem aviso: um : no meio (por exemplo Vi du: … ou Exemplo: …), um : no final, começando com [ { > | ' " * ! % @ , ou uma crase, ou começando com - ? : (o caractere seguido por um espaço). (2) Mudança silenciosa de significado — faz o parse mas está errado: começar com # deixa a descrição vazia, # no meio corta o resto, começar com & transforma em uma âncora. Aspas duplas evitam ambos; dentro das aspas duplas não use " ou \.
Registros com validação estrita também frequentemente bloqueiam: caminhos absolutos contendo uma letra de unidade do Windows (drive + dois-pontos + barra — escreva <root>/… em vez de codificar uma unidade), strings que parecem credenciais, links quebrados de markdown dentro do pacote, e qualquer script .py que não force stdout/stderr para UTF-8. Revisão independente também frequentemente rejeita sintaxe que só funciona no sandbox do claude.ai (/mnt/skills/…, /mnt/user-data/outputs/, present_files, extract-text) — escreva instruções neutras em relação ao host.
5 Padrões (escolha exatamente 1)
Fluxo de Trabalho Sequencial | Coordenação Multi-MCP | Refinamento Iterativo | Seleção de Ferramentas Ciente do Contexto | Inteligência Específica de Domínio
9 Tipos de Skill (escolha exatamente 1)
Referência de Biblioteca e API | Verificação de Produto | Code Scaffolding & Templates | Automação de Processos de Negócios | Captura e Análise de Dados | Qualidade e Revisão de Código | CI/CD & Implantação | Runbooks | Operações de Infraestrutura
Protocolo de Escrita de Descrição (OBRIGATÓRIO)
Objetivo: taxa de ativação de 72–90%.
| Requisito | Detalhe |
|---|---|
| Frases de gatilho | Pelo menos 5 frases (em todos os idiomas que seus usuários escrevem, romanizados se necessário, ex. inglês + vietnamita) |
| Estilo | Situacional: "Use quando o usuário quiser...", "SEMPRE QUE..." |
| Exemplos reais | Pelo menos alguns exemplos de prompts que os usuários realmente digitam |
| Comprimento | Abaixo de 1024 caracteres |
| Sem diacríticos | Campos YAML apenas: ASCII simples — remova toda letra acentuada e marca de tom (ex. vietnamita ă â ê ô ơ ư đ). Para idiomas não escritos em alfabeto latino, use frases de gatilho romanizadas ou em inglês |
| Sem colchetes angulares | Nunca use colchetes angulares de abertura/fechamento |
| Bloqueador negativo | Termine com uma frase de bloqueio: "Não use quando..." |
Exemplo de uma Descrição padrão (ASCII simples):
Use quando o usuario quiser adicionar conteudo a um Wiki de IA no Notion, salvar conhecimento de IA,
classificar links de artigos, notas, ferramentas, prompts. SEMPRE QUE o usuario colar um link,
uma nota, um nome de ferramenta ou um prompt de IA para guardar. Exemplos - salvar este link no wiki,
adicionar esta ferramenta ao notion, guardar este prompt, salvar este artigo. Nao use quando o
usuario apenas fizer uma pergunta de conhecimento ou pedir novo conteudo sem intencao de salvar.
Lista de Verificação de 14 Itens (PORTÃO — 14/14 obrigatório)
| # | Critério | Passa quando |
|---|---|---|
| 1 | name está em kebab-case correto e não contém "claude"/"anthropic" | ☐ |
| 2 | YAML tem name + version + description (+ pattern + type) | ☐ |
| 3 | description atende totalmente ao Protocolo de Descrição | ☐ |
| 4 | Sem colchetes angulares na descrição | ☐ |
| 5 | Corpo do SKILL.md abaixo de 500 linhas (partes longas transferidas para referências) | ☐ |
| 6 | Exatamente 1 Padrão + 1 Tipo de Skill escolhidos | ☐ |
| 7 | Não ensina fundamentos que a IA já conhece | ☐ |
| 8 | Tem problemas reais (pelo menos 5) | ☐ |
| 9 | Estrutura adequada à necessidade: documentação longa dividida em references/ com ponteiros claros | ☐ |
| 10 | Lógica repetitiva/determinística empacotada como scripts/ em vez de descrita manualmente | ☐ |
| 11 | Descrição otimizada para ativação + tem um bloqueador negativo | ☐ |
| 12 | Testado 3 casos positivos + 3 negativos | ☐ |
| 13 | Reescrito por completo (sem remendos) se for uma atualização | ☐ |
| 14 | Verificação de Diferenças feita: toda tabela/esquema/valor/problema/caso de teste original ainda está completo, nada comprimido ou truncado | ☐ |
Responda ao usuário apenas quando todos os 14/14 passarem.
6 Princípios de Ouro
- Não ensine o que a IA já sabe — foque apenas no contexto específico + problemas.
- Problemas são o ativo mais valioso — registre cada falha repetida.
- Mantenha-se atualizando — cada erro = um novo problema → atualize imediatamente.
- Menor estrutura que é suficiente — simples = 1 arquivo, complexo = dividir em uma pasta e usar Divulgação Progressiva.
- Reescrever completamente = reestruturar, não comprimir — preserve o conteúdo técnico completamente; se for muito longo, divida em referências, não comprima.
- Nunca corrija pedaço por pedaço.
Formato de Saída ao responder ao usuário (OBRIGATÓRIO, nesta ordem)
- Resumo da skill — propósito, padrão, tipo, estrutura (arquivo único ou pasta).
- Conteúdo completo do SKILL.md — em um bloco de código; se for uma pasta, liste também os arquivos
references//scripts//assets/. - Guia de implantação — etapas concretas para o ambiente alvo.
- Resultados dos testes — 3 casos positivos + 3 negativos.
- Verificação de Diferenças — confirme que nenhum conteúdo original foi perdido (se for uma atualização/reescrita).
- Problemas tratados — se for uma atualização.
- Versão — a versão no YAML.
Guia de implantação
Skill em pasta (Claude Code / agente / API):
- Crie a pasta
nome-da-skill-em-kebab-case/. - Coloque
SKILL.mdna raiz, maisscripts/,references/,assets/se houver. - Instale a skill da maneira que o ambiente espera (pasta de diretório de skills ou um pacote
.skill). - Acione 1 prompt positivo para confirmar a ativação.
Skill em arquivo único (interface do usuário do claude.ai / formulário livre):
- Copie o conteúdo do bloco de código diretamente para o campo de skill configurada.
- Ajuste o frontmatter YAML conforme necessário (veja a seção de Variantes por AMBIENTE ALVO).
- Se a skill usa
references/externos, você deve hospedá-los separadamente e carregá-los no contexto. - Teste a ativação com 1 prompt positivo.
Notas de compatibilidade
- Esta skill é uma meta-skill — ela gera outras skills.
- Todo gerador de skill gerado por esta skill é portável entre ambientes (Claude Code, claude.ai, Grok, API REST) desde que o frontmatter YAML esteja correto para o alvo.
- Sempre pergunte sobre o ambiente alvo ANTES de escrever o frontmatter.
- Ao escrever descrições, use frases de gatilho em todos os idiomas que seus usuários escrevem. Romanize se necessário.
Notas do desenvolvedor
- O "Skill Engineer Protocol v2.2" referenciado no nome e no cabeçalho da skill é o nome do processo que esta skill segue, não uma versão de release.
- O número de versão real é 2.4.1 (versão maior).
- Ao atualizar esta skill, mantenha a Regra Suprema (preservação de conteúdo) para evitar perda de detalhes técnicos.
- A Lista de Verificação de 14 Itens é a porta de saída — nenhuma saída deve ser dada até que todos os 14 passem.