📁 Pasta + SKILL.md
A estrutura mínima de uma skill é absoluta: uma pasta com qualquer nome e dentro dela um único arquivo chamado SKILL.md. Só isso. Nada mais é obrigatório.
Uma skill é uma pasta. Dentro dela mora o SKILL.md — o único arquivo que o Claude Code precisa para carregar e executar o comportamento definido. Opcionalmente a pasta pode ter uma subpasta references/ com arquivos de apoio.
Quando o Claude Code encontra SKILL.md na pasta de skills configurada (~/.claude/skills/), ele disponibiliza aquela skill como um comando /nome-da-skill.
references/house-style.md
scripts/composition-template.mjs
O nome da pasta vira o nome do comando. video-explicativo/ vira /video-explicativo. Escolha nomes descritivos sem espaços — use hífens.
📦 Conhecimento empacotado
Uma skill não é um prompt efêmero digitado na hora — é um procedimento reutilizável, testado e versionável. É conhecimento que você ensina uma vez e o Claude aplica toda vez que precisar.
Pense numa receita de cozinha. Você não re-inventa a receita toda vez que vai cozinhar — você a escreveu uma vez, guardou e segue. Uma skill é exatamente isso: a receita escrita, guardada e reutilizável para qualquer "cozinhada" futura.
O SKILL.md da video-explicativo define o fluxo completo de criação de vídeos: roteiro → narração TTS → cenas animadas → render → captions → CTA. Esse conhecimento fica empacotado e pronto para reuso.
Descreve no SKILL.md o procedimento, as regras de ouro, os padrões de qualidade. Pode levar 30 minutos — ou horas se for complexo.
Toda vez que você invocar /video-explicativo, o Claude carrega o SKILL.md e segue as instruções — sem você precisar repetir nada.
O vídeo do INEMA.CLUB tem sempre paleta #0D1321, voz pf_dora --speed 0.98, fade de 0.45s — porque está escrito na skill.
Quando você descobrir algo melhor (ex.: novo timing de LEAD ou TAIL), edita o SKILL.md uma vez e todos os vídeos futuros já herdam a melhoria.
Se o procedimento está só na sua memória, cada nova sessão começa do zero. Você fica re-explicando o mesmo fluxo ao Claude, cometendo os mesmos erros, perdendo consistência. A skill elimina esse custo.
✍️ Markdown como instrução
O corpo do SKILL.md é puro Markdown. Claude interpreta esse texto como instruções de execução — não como documentação para humanos, mas como ordens que ele vai seguir.
O SKILL.md tem duas partes: o front-matter (cabeçalho com name: e description:) e o corpo — seções Markdown com o procedimento completo. O Claude Code usa o front-matter para listar e ativar a skill; o corpo para executá-la.
- ✓ Escreva em imperativo: "Leia…", "Crie…", "Gere…"
- ✓ Use seções com
##para separar fluxo e regras - ✓ Inclua valores exatos:
--speed 0.98, não "velocidade lenta" - ✓ Marque não-negociáveis com "NUNCA" ou "SEMPRE"
- ✗ Não seja vago: "faça um bom vídeo" não funciona
- ✗ Não omita o front-matter (name: e description:)
- ✗ Não escreva como documentação técnica passiva
- ✗ Não coloque instruções de execução nos arquivos de referência
Quando você digita /video-explicativo, o Claude Code injeta o conteúdo completo do SKILL.md no contexto da sessão antes de responder. Por isso, instruções no início e no fim têm o mesmo peso.
⚖️ Skill vs prompt avulso
Um prompt avulso funciona uma vez, naquela sessão, com aquele contexto. Uma skill é durável, automática e reproduzível — a diferença entre um post-it e um manual de operações.
| Aspecto | Skill | Prompt avulso |
|---|---|---|
| Durabilidade | Permanente (arquivo) | Efêmero (morre com a sessão) |
| Ativação | Automática via /nome | Manual, você digita tudo |
| Consistência | Idêntico toda vez | Varia conforme memória |
| Manutenção | Edita o arquivo | Re-escreve todo prompt |
| Compartilhamento | Git, zip, cópia de pasta | Ctrl+C / Ctrl+V manual |
- ✓ Vai repetir o mesmo tipo de tarefa muitas vezes
- ✓ Precisa de consistência absoluta (branding, formato)
- ✓ Quer compartilhar o procedimento com outros
- ✓ O fluxo tem mais de 3 passos ou regras críticas
- ✗ É uma pergunta única, não vai se repetir
- ✗ O contexto muda completamente a cada vez
- ✗ Exploração rápida, sem necessidade de reprodução
- ✗ Tarefa de 1 passo sem parâmetros específicos
Uma heurística simples: se você imagina fazer a mesma tarefa 3 ou mais vezes, o tempo investido em escrever o SKILL.md se paga já na quarta execução. Abaixo de 3, prompt avulso é mais rápido.
🎯 Exemplos: vídeo, código, UI
Skills cobrem qualquer domínio — não só vídeo. Este curso inteiro nasceu de uma skill (formato-curso). Veja a variedade possível.
Cada página deste curso foi criada pela skill formato-curso. Ela define os componentes, o CSS dark premium, a estrutura de módulos e os padrões de qualidade do INEMA.CLUB — tudo em Markdown, sem linha de código JavaScript.
A skill video-explicativo (que este curso ensina) define o fluxo HTML→MP4: paleta #0D1321, voz pf_dora, timings LEAD=0.5 TAIL=0.9 FADE=0.45. Dois domínios, mesma estrutura: pasta + SKILL.md.
Roteiro → TTS pf_dora → cenas HTML dark → render MP4. Fluxo de 8 passos fixos, paleta #0D1321, formatos 16:9 e 9:16.
Gera HTML com Tailwind, SVGs futuristas, tópicos expansíveis e modais. Define todos os componentes e paletas por trilha.
Fan-out de buscas, verifica fontes, sintetiza relatório citado. Skill de pesquisa com verificação adversarial.
Gera e valida fluxos de automação n8n com padrões de código JavaScript e expressões de nó específicos.
Cria componentes e páginas web com padrões visuais específicos, tokens de design e guias de estilo.
Audita código em busca de vulnerabilidades com checklists de OWASP e padrões de segurança específicos.
→ lista todas as skills ativas
→ cada uma = uma pasta
→ cada pasta = um SKILL.md
🚀 Sem escrever código
Uma skill simples é só texto. Você não precisa saber JavaScript, Python ou qualquer linguagem de programação para criar skills poderosas — Markdown é suficiente.
Quando você escreve "1. Leia o assunto. 2. Crie roteiro de 3 cenas. 3. Use voz pf_dora." no SKILL.md, isso é um programa. Claude interpreta instruções em linguagem natural com a mesma fidelidade que um computador interpreta código.
A skill video-explicativo tem centenas de instruções precisas — timings, paletas, formatos — e é inteiramente Markdown. Zero JavaScript no SKILL.md principal.
A pasta references/ pode conter scripts como narration-template.sh e composition-template.mjs — mas esses são templates que o Claude usa como modelo, não código que a skill executa diretamente. A skill instrui; os templates exemplificam.
- ✓ Crie a pasta e o SKILL.md em 10 minutos
- ✓ Escreva instruções claras em português
- ✓ Teste chamando
/nome-da-skillno Claude Code - ✓ Itere: edite o SKILL.md conforme aprende
- ✗ Não espere saber programar para começar
- ✗ Não tente cobrir todos os casos de uso de uma vez
- ✗ Não use YAML complexo onde Markdown serve
- ✗ Não espere a skill estar "perfeita" para usar
A skill mais simples possível: name: minha-skill, description: o que faz, e 3-5 passos em Markdown. Execute, ajuste, expanda. A skill video-explicativo que você vai aprender neste curso começou assim — e hoje tem referências, scripts e centenas de regras.
Instruções de tom, formato, assinatura padrão. 8 linhas. Economiza 5 minutos por email.
Template de seções, métricas obrigatórias, tom executivo. 12 linhas. Consistência total.
Checklist de hipóteses, formato de diagnóstico, padrão de commit de fix. 10 linhas.
📋 Resumo do Módulo 1.1
- ✓ Skill = pasta +
SKILL.md— estrutura mínima e suficiente - ✓ Conhecimento empacotado: escreve uma vez, reutiliza sempre
- ✓ O corpo do SKILL.md é Markdown que o Claude executa como instruções
- ✓ Skill é durável + automática; prompt avulso é efêmero + manual
- ✓ Domínios: vídeo, código, UI, pesquisa — este curso nasceu de uma skill
- ✓ Comece com 10 linhas de Markdown — sem código necessário
references/.