61ec71c5c7
New skills covering 10 categories: **Security & Audit**: 007 (STRIDE/PASTA/OWASP), cred-omega (secrets management) **AI Personas**: Karpathy, Hinton, Sutskever, LeCun (4 sub-skills), Altman, Musk, Gates, Jobs, Buffett **Multi-agent Orchestration**: agent-orchestrator, task-intelligence, multi-advisor **Code Analysis**: matematico-tao (Terence Tao-inspired mathematical code analysis) **Social & Messaging**: Instagram Graph API, Telegram Bot, WhatsApp Cloud API, social-orchestrator **Image Generation**: AI Studio (Gemini), Stability AI, ComfyUI Gateway, image-studio router **Brazilian Domain**: 6 auction specialist modules, 2 legal advisors, auctioneers data scraper **Product & Growth**: design, invention, monetization, analytics, growth engine **DevOps & LLM Ops**: Docker/CI-CD/AWS, RAG/embeddings/fine-tuning **Skill Governance**: installer, sentinel auditor, context management Each skill includes: - Standardized YAML frontmatter (name, description, risk, source, tags, tools) - Structured sections (Overview, When to Use, How it Works, Best Practices) - Python scripts and reference documentation where applicable - Cross-platform compatibility (Claude Code, Antigravity, Cursor, Gemini CLI, Codex CLI) Co-authored-by: ProgramadorBrasil <214873561+ProgramadorBrasil@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
Catálogo de Problemas por Domínio
Skills e Orchestrator
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| YAML inválido no SKILL.md | Alta | python -c "import yaml; yaml.safe_load(open('SKILL.md').read())" |
name ou description duplicados no YAML |
Média | Grep por ^name: no arquivo — deve ter 1 ocorrência |
| skill-installer falha silenciosamente | Média | Usar --force e ler output completo |
| scan_registry.py bug com sets/dicts | Baixa | Atualizar registry manualmente via JSON |
| Skill no .claude mas não em skills/ | Média | Sempre instalar via skill-installer, não copiar manual |
APIs e Integrações
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| Token/API key expirado | Alta | Verificar validade antes de executar |
| Rate limit atingido | Média | Implementar retry com backoff exponencial |
| Endpoint mudou (breaking change) | Baixa | Fixar versão da API, checar changelog antes |
| HMAC-SHA256 inválido em webhooks | Média | Testar com payload de exemplo antes de ir live |
| Credencial hardcoded commitada | Baixa mas crítica | .env obrigatório + .gitignore configurado |
Arquivos e Paths
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| Path não existe | Alta | os.path.exists() antes de qualquer operação |
| Permissão negada | Média | Verificar com os.access(path, os.W_OK) |
| Encoding errado (pt-BR com acentos) | Alta | open(f, encoding='utf-8') explícito sempre |
| ZIP corrompido | Baixa | Verificar com zipfile.is_zipfile() após geração |
| Arquivo aberto por outro processo | Baixa | Fechar handles explicitamente com with |
ZIPs e Builds do Ecossistema
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| ecosystem-completo.zip desatualizado | Alta | Executar build_ecosystem.py após cada nova skill |
| Skill numerada fora de ordem | Média | Verificar contagem total antes de atribuir número |
| ZIP muito grande (>50MB) | Baixa | Excluir pycache, .pyc, node_modules |
Git
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| Commit na branch errada | Alta | git branch --show-current antes de commits |
| Uncommitted changes perdidos | Média | git status antes de operações destrutivas |
| Merge conflict | Média | git pull --rebase antes de push |
| Push de secrets | Baixa mas crítica | git diff --staged antes de commit |
Python / Scripts
| Problema | Frequência | Solução Preventiva |
|---|---|---|
| ModuleNotFoundError | Alta | pip install -r requirements.txt primeiro |
| Python 2 vs 3 | Baixa | Usar python3 explicitamente |
| Subprocess sem timeout | Média | Sempre subprocess.run(..., timeout=30) |
| JSON decode error | Média | Tratar json.JSONDecodeError explicitamente |
| UnicodeDecodeError | Alta | encoding='utf-8', errors='replace' em files |