Thiago Feral Skills

Repositório central das minhas skills para o Claude. Cada skill é uma capacidade reutilizável que o Claude carrega sozinho quando faz sentido — instruções, contexto e boas práticas empacotadas numa pasta. Funciona no claude.ai (Web) e no Claude Code (pasta local).

O que é uma skill? Uma pasta com um SKILL.md (instruções + um cabeçalho com name e description) e, opcionalmente, uma pasta references/. O Claude lê a descrição e decide quando usar.

---

Como uma skill funciona

flowchart LR
    U([Você descreve<br/>uma tarefa]) --> C{Claude lê as<br/>descrições das skills}
    C -- combina --> S[Carrega a SKILL.md<br/>+ references sob demanda]
    C -- não combina --> N[Responde normalmente]
    S --> O([Executa seguindo<br/>a metodologia da skill])

A description no topo do SKILL.md é o gatilho. Skills bem descritas disparam em pedidos substantivos sem você precisar "chamá-las" — embora você sempre possa pedir explicitamente.

---

Catálogo de skills

Skill	O que faz	Superfícies	Requisitos
auditoria-de-sistema	Auditoria de segurança e prontidão: OWASP ASVS, API Security Top 10, banco ao vivo e logs de produção, com verificação obrigatória de cada achado. Pontua estrutura (A) e produto (B) de 0 a 10, placar OWASP Top 10 e veredito "pronto para clientes?". Tem modo de reauditoria.	Web · Claude Code	Repositório; banco e logs de produção (recomendado)
avaliacao-trafego-meta	Nota de 0 a 10 e veredito (escalar, manter, aguardar ou pausar) para campanhas, conjuntos e anúncios de venda direta no Meta Ads, com limiares de lucro derivados dos números do negócio.	Web · Claude Code	Dados das campanhas
music-master	Masterização por gênero, volume padronizado (LUFS/pico real), comparação A/B nivelada, organização de álbum (renumeração, tags, gênero por faixa, capa) e exportação WAV/MP3 para YouTube, streaming ou distribuidora. Qualquer gênero e origem (Suno, DAW…).	Claude Code	Node 18+ e ffmpeg

Novas skills entram aqui conforme forem criadas. Veja CONTRIBUTING.md para o padrão.

---

Estrutura do repositório

thiago-feral-skills/
├── README.md                     ← este arquivo
├── LICENSE
├── CONTRIBUTING.md               ← como adicionar uma nova skill
├── docs/
│   └── INSTALL.md                ← guia de instalação (Web + Claude Code)
├── assets/
│   └── hub-banner.svg
└── skills/
    └── auditoria-de-sistema/
        ├── SKILL.md              ← o que o Claude carrega
        ├── README.md             ← documentação para humanos
        ├── references/           ← material de apoio, sob demanda
        └── scripts/ · evals/     ← opcionais

---

Instalação rápida

O guia completo, com prints conceituais e solução de problemas, está em docs/INSTALL.md. Resumo:

1. Compacte a pasta da skill em um ZIP:

   cd skills && zip -r auditoria-de-sistema.zip auditoria-de-sistema
   

2. No claude.ai: Customize → Skills → "+" → "+ Create skill" e faça upload do ZIP.
3. Deixe a skill ligada no toggle. Pronto.

git clone https://github.com/<SEU-USUARIO>/thiago-feral-skills.git
mkdir -p ~/.claude/skills
cp -r thiago-feral-skills/skills/auditoria-de-sistema ~/.claude/skills/

Inicie uma nova sessão (claude) e peça a tarefa. Skill pessoal vale em todos os projetos; para compartilhar com o time, copie para <repo>/.claude/skills/ (vai junto no git).

Skills não sincronizam entre superfícies — instale em cada lugar onde for usar.

---

Adicionar uma nova skill

1. Crie skills/<nome-da-skill>/SKILL.md (com name e description no cabeçalho).
2. Adicione references/ se precisar de material de apoio carregado sob demanda.
3. Escreva um README.md da skill (use o da auditoria-de-sistema como modelo).
4. Registre a skill na tabela do catálogo acima.

Detalhes e convenções em CONTRIBUTING.md.

---

Licença

MIT. Use, adapte e compartilhe. As skills são material de orientação — revise as saídas antes de agir, especialmente em contextos de segurança.

---