Skills

Agent skills que criei a partir de projetos reais. Cada uma encapsula aprendizados que um agente de IA pode carregar para evitar os mesmos erros e aplicar os mesmos padrões. Formato agentskills.io.

📊 CSS/HTML Diagrams

Diagramas de pipeline e arquitetura usando apenas HTML e CSS puro. Setas animadas, nós com tema escuro, responsivo. Substitui Mermaid, ASCII art e ferramentas externas.

Criada após aprender que diagramas Mermaid adicionam ~500KB de JS ou exigem Playwright no build. O approach CSS/HTML nos deu controle total de estilo, animações e responsividade sem nenhuma dependência.

🌳 Genealogy Research

Guia completo para agentes de pesquisa genealógica: entrevistas, OCR, YAMLs, FamilySearch/Ancestry, human-in-the-loop e padrões regionais de imigração.

Nasceu do meu projeto pessoal de genealogia, rastreando 6 linhas familiares (italiana, portuguesa, espanhola, polonesa). Documentei o processo para que outros agentes possam fazer o mesmo.

🤖 llms.txt Generator

Gera arquivos llms.txt, llms-full.txt e humans.txt seguindo o padrão llmstxt.org para discoverability por LLMs e agentes de IA.

Implementamos o padrão na StartSe e em outros sites do Grupo Alun. A skill captura as lições aprendidas: quais fontes de dados usar, como estruturar, e como crawlar sites sem acesso ao código.

💬 Baileys WhatsApp

Padrões de produção para integração com WhatsApp via Baileys (Node.js). Session management, histórico de mensagens, metadados de grupo e armadilhas que causam perda silenciosa de dados.

Aprendizados dolorosos ao construir o Ceres (meu cliente de comunicação). Baileys é poderoso mas cheio de gotchas não documentados que descobrimos na prática.

🤖 Telegram + Claude Assistant

Padrões de produção para assistentes pessoais no Telegram com claude -p: sessão por chat, lógica de negócio em arquivos, contrato de saída (bubbles, SEND_FILE), nunca falhar em silêncio, armadilhas de systemd, guardrails hard e os perigos de bots que se auto-programam.

Destilada de três assistentes reais rodando no servidor de casa: o bot da casa, a secretária da família e o bot de notas/PKM. Cada regra custou pelo menos um bug de verdade — inclusive a lição de que auto-programação dissolve todos os outros guardrails.

💡 Govee LAN Protocol

Controle de luzes Govee além da API oficial: o protocolo LAN de modo música com paleta customizada (decodificado por engenharia reversa), por que o HTTP 200 mente sobre liveness, e por que IDs de perfil não são portáveis entre aparelhos.

Nasceu do sistema de controle da casa do Paulo. Um bug bobo ('deixa a luz azul' e ela continuou dançando) virou a decodificação de um protocolo binário que não está documentado em lugar nenhum da internet.

Cada skill é um arquivo Markdown (SKILL.md) que pode ser carregado por qualquer agente de IA. Clique em um card para ver o conteúdo completo.