nova-skill-creator

Use quando o usuário quiser escrever uma nova skill, criar uma skill, construir uma skill para um agente de IA, atualizar uma skill, editar ou corrigir uma skill, ou revisar e auditar uma skill para Claude, Grok ou outro LLM. SEMPRE que o usuário mencionar uma skill, SKILL.md, um SOP para IA, um funcionário virtual ou um engenheiro de skills.

O que é nova-skill-creator?

Nova Skill Creator é uma meta-skill que transforma qualquer solicitação relacionada a skills (criar nova, atualizar, editar, revisar) em um processo de engenharia padronizado, produzindo skills profissionais prontas para implantação imediata. Ela segue o 'Skill Engineer Protocol v2.2', que é o nome do processo, não o número da versão. A skill suporta múltiplos alvos, incluindo contas claude.ai, Grok, Claude Code, Codex e outros LLMs, com variações no frontmatter YAML dependendo do ambiente alvo. O processo inclui 8 etapas para criar uma nova skill, 8 etapas para atualizar/editar, e uma checklist de 14 itens que deve ser totalmente aprovada antes de concluir. Uma regra suprema é preservar todo o conteúdo técnico durante reescritas, usando uma abordagem de 'reescrita completa = reestruturação, não compressão', com um inventário de conteúdo obrigatório e verificação de diferenças para garantir que nenhuma tabela, esquema, valor ou caso de teste seja perdido. A skill também enfatiza a estrutura de pasta com SKILL.md como arquivo principal, suporte a Progressive Disclosure (3 níveis de carregamento) e a divisão de conteúdo longo em referências/ em vez de comprimi-lo.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/chuong1224/nova-skill-creator/tree/HEAD/skills/nova-skill-creator

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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çãoRemover tabelas, linhas, colunas, exemplos
Manter cada valor/esquema/ID/regra exatamente como estãoParafrasear um esquema como "aproximadamente"
Número de itens de saída >= número de itens de entradaReduzir de 10 problemas para 4
Aumentar clarezaReduzir detalhes "para encurtar"

Processo anti-compressão de 3 etapas — OBRIGATÓRIO antes/depois de cada reescrita ou atualização:

  1. 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.
  2. 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.
  3. 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.

ComplexidadeEstrutura recomendada
Skill simples e curtaApenas 1 arquivo SKILL.md (ainda válido)
Skill com lógica repetitiva/determinísticaPasta + scripts/
Skill multi-domínio / documentação longaPasta + 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ívelConteúdoQuando entra no contexto
1Metadados (name + description)Sempre (~100 palavras)
2Corpo do SKILL.mdQuando a skill é ativada (idealmente abaixo de 500 linhas)
3Recursos agrupadosQuando 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)

#EtapaDescrição
1Perguntar por informações faltantesObjetivo, 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
2Escolher 1 Padrão + 1 Tipo de SkillExatamente 1 de cada (veja as listas abaixo)
3Escrever a Descrição PRIMEIROA etapa mais importante — siga o Protocolo de Descrição abaixo
4Escolher a estrutura + projetar o conteúdoArquivo único ou pasta? O que fica inline, o que vai para references/, qual lógica se torna scripts/
5Escrever SKILL.mdYAML + Fluxo de Trabalho + Regras/Esquemas + Problemas; corpo abaixo de 500 linhas, transfira partes longas para referências
6Escrever scripts/references (se necessário)Lógica determinística/repetitiva → scripts/; documentação longa → references/ com ponteiros
7Testar ativação3 casos positivos + 3 negativos
8Responder usando o Formato de SaídaVeja 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)

  1. Leia todo o SKILL.md atual (e seus arquivos agrupados).
  2. Inventário primeiro — liste cada tabela/esquema/valor/problema/caso de teste que NÃO deve ser perdido (regra suprema, etapa 1).
  3. Registre problemas do usuário e de execuções anteriores.
  4. Avalie contra a Lista de Verificação de 14 itens.
  5. Identifique o tipo de falha: Sub-ativação / Super-ativação / Erro de execução / Perda de conteúdo (compressão/truncamento).
  6. Reescreva tudo sob a restrição de preservação — reestruture, NÃO comprima. NUNCA corrija pedaço por pedaço.
  7. Verifique depois — compare a saída com o inventário, restaure qualquer coisa faltando.
  8. 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.

AlvoFrontmatterOnde Version / Pattern / Type vão
Conta claude.ai, Grok, outros LLMs5 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 estritaAPENAS name + description, cada um em UMA linha — sem >-, sem linhas indentadas, sem terceiro campouma 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%.

RequisitoDetalhe
Frases de gatilhoPelo menos 5 frases (em todos os idiomas que seus usuários escrevem, romanizados se necessário, ex. inglês + vietnamita)
EstiloSituacional: "Use quando o usuário quiser...", "SEMPRE QUE..."
Exemplos reaisPelo menos alguns exemplos de prompts que os usuários realmente digitam
ComprimentoAbaixo de 1024 caracteres
Sem diacríticosCampos 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 angularesNunca use colchetes angulares de abertura/fechamento
Bloqueador negativoTermine 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érioPassa quando
1name está em kebab-case correto e não contém "claude"/"anthropic"☐
2YAML tem name + version + description (+ pattern + type)☐
3description atende totalmente ao Protocolo de Descrição☐
4Sem colchetes angulares na descrição☐
5Corpo do SKILL.md abaixo de 500 linhas (partes longas transferidas para referências)☐
6Exatamente 1 Padrão + 1 Tipo de Skill escolhidos☐
7Não ensina fundamentos que a IA já conhece☐
8Tem problemas reais (pelo menos 5)☐
9Estrutura adequada à necessidade: documentação longa dividida em references/ com ponteiros claros☐
10Lógica repetitiva/determinística empacotada como scripts/ em vez de descrita manualmente☐
11Descrição otimizada para ativação + tem um bloqueador negativo☐
12Testado 3 casos positivos + 3 negativos☐
13Reescrito por completo (sem remendos) se for uma atualização☐
14Verificaçã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

  1. Não ensine o que a IA já sabe — foque apenas no contexto específico + problemas.
  2. Problemas são o ativo mais valioso — registre cada falha repetida.
  3. Mantenha-se atualizando — cada erro = um novo problema → atualize imediatamente.
  4. Menor estrutura que é suficiente — simples = 1 arquivo, complexo = dividir em uma pasta e usar Divulgação Progressiva.
  5. Reescrever completamente = reestruturar, não comprimir — preserve o conteúdo técnico completamente; se for muito longo, divida em referências, não comprima.
  6. Nunca corrija pedaço por pedaço.

Formato de Saída ao responder ao usuário (OBRIGATÓRIO, nesta ordem)

  1. Resumo da skill — propósito, padrão, tipo, estrutura (arquivo único ou pasta).
  2. Conteúdo completo do SKILL.md — em um bloco de código; se for uma pasta, liste também os arquivos references/ / scripts/ / assets/.
  3. Guia de implantação — etapas concretas para o ambiente alvo.
  4. Resultados dos testes — 3 casos positivos + 3 negativos.
  5. Verificação de Diferenças — confirme que nenhum conteúdo original foi perdido (se for uma atualização/reescrita).
  6. Problemas tratados — se for uma atualização.
  7. Versão — a versão no YAML.

Guia de implantação

Skill em pasta (Claude Code / agente / API):

  1. Crie a pasta nome-da-skill-em-kebab-case/.
  2. Coloque SKILL.md na raiz, mais scripts/, references/, assets/ se houver.
  3. Instale a skill da maneira que o ambiente espera (pasta de diretório de skills ou um pacote .skill).
  4. Acione 1 prompt positivo para confirmar a ativação.

Skill em arquivo único (interface do usuário do claude.ai / formulário livre):

  1. Copie o conteúdo do bloco de código diretamente para o campo de skill configurada.
  2. Ajuste o frontmatter YAML conforme necessário (veja a seção de Variantes por AMBIENTE ALVO).
  3. Se a skill usa references/ externos, você deve hospedá-los separadamente e carregá-los no contexto.
  4. 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.

Habilidades Relacionadas