mega-brain-ai 1.1.0

package/.claude/skills/skill-writer/examples.md

@@ -0,0 +1,191 @@
+# Skill Examples
+
+Common patterns and templates for creating Skills.
+
+## Read-only Skill
+
+For Skills that only analyze without modifying:
+
+```yaml
+---
+name: code-reader
+description: Read and analyze code without making changes. Use for code review, understanding codebases, or documentation.
+allowed-tools: Read, Grep, Glob
+---
+
+# Code Reader
+
+Analyze code structure and patterns without making modifications.
+
+## Instructions
+
+1. Use Glob to find relevant files
+2. Use Read to examine content
+3. Use Grep to search patterns
+4. Report findings without editing
+```
+
+## Script-based Skill
+
+For Skills that use helper scripts:
+
+```yaml
+---
+name: data-processor
+description: Process CSV and JSON data files with Python scripts. Use when analyzing data files or transforming datasets.
+---
+
+# Data Processor
+
+## Instructions
+
+1. Use the processing script:
+```bash
+python scripts/process.py input.csv --output results.json
+```
+
+2. Validate output:
+```bash
+python scripts/validate.py results.json
+```
+
+## Requirements
+
+```bash
+pip install pandas
+```
+```
+
+## Multi-file Skill (Progressive Disclosure)
+
+For complex Skills with extensive documentation:
+
+```yaml
+---
+name: api-designer
+description: Design REST APIs following best practices. Use when creating API endpoints, designing routes, or planning API architecture.
+---
+
+# API Designer
+
+Quick start: See [examples.md](examples.md)
+
+Detailed reference: See [reference.md](reference.md)
+
+## Instructions
+
+1. Gather requirements
+2. Design endpoints (see examples.md)
+3. Document with OpenAPI spec
+4. Review against best practices (see reference.md)
+```
+
+## Description Examples
+
+### Good Descriptions
+
+```yaml
+# Specific actions + file types + trigger words
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+
+# Clear scope + when to use
+description: Analyze Excel spreadsheets, create pivot tables, and generate charts. Use when working with Excel files, spreadsheets, or analyzing tabular data in .xlsx format.
+
+# Action-oriented + context
+description: Generate git commit messages following conventional commits format. Use when the user wants to commit changes or needs help writing commit messages.
+```
+
+### Bad Descriptions
+
+```yaml
+# Too vague
+description: Helps with documents
+
+# No trigger context
+description: For data analysis
+
+# Too broad
+description: General purpose tool for files
+```
+
+## Validation Checklist Template
+
+Include this in your Skill for self-validation:
+
+```markdown
+## Validation checklist
+
+Before finalizing, verify:
+
+- [ ] Name is lowercase, hyphens only, max 64 chars
+- [ ] Name matches directory name exactly
+- [ ] Description < 1024 chars
+- [ ] Description includes "what" and "when"
+- [ ] YAML frontmatter has no tabs
+- [ ] Instructions are step-by-step
+- [ ] Examples use real code
+- [ ] Dependencies documented
+- [ ] File paths use forward slashes
+```
+
+## File Structure Examples
+
+### Minimal Skill (single file)
+
+```
+commit-helper/
+└── SKILL.md
+```
+
+### Standard Skill (with examples)
+
+```
+pdf-processor/
+├── SKILL.md
+└── examples.md
+```
+
+### Complex Skill (full structure)
+
+```
+api-designer/
+├── SKILL.md
+├── reference.md
+├── examples.md
+├── templates/
+│   └── openapi.yaml
+└── scripts/
+    └── validate.py
+```
+
+## Frontmatter Options
+
+### Basic (required fields only)
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+---
+```
+
+### With tool restrictions
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+allowed-tools: Read, Grep, Glob, Write, Edit
+---
+```
+
+### Full options
+
+```yaml
+---
+name: my-skill
+description: What it does. Use when X happens.
+allowed-tools: Read, Grep, Glob
+model: claude-sonnet-4-20250514
+---
+```

package/.claude/skills/skill-writer/troubleshooting.md

@@ -0,0 +1,205 @@
+# Troubleshooting Skills
+
+Common issues and solutions when creating or debugging Skills.
+
+## Skill doesn't activate
+
+**Symptoms**: Claude doesn't use your Skill when you expect it to.
+
+**Solutions**:
+
+1. **Make description more specific**
+   ```yaml
+   # Before (too vague)
+   description: Helps with documents
+
+   # After (specific triggers)
+   description: Extract text from PDF files. Use when working with PDFs or document extraction.
+   ```
+
+2. **Include trigger words users would say**
+   - Add file extensions: `.pdf`, `.xlsx`, `.json`
+   - Add action verbs: "analyze", "extract", "generate", "create"
+   - Add context: "Use when...", "For..."
+
+3. **Check the "Use when" clause**
+   ```yaml
+   description: [What it does]. Use when [specific scenario].
+   ```
+
+## Skill not found
+
+**Symptoms**: Skill doesn't appear in available skills list.
+
+**Check**:
+
+1. **File location**
+   ```bash
+   # Personal skills
+   ls ~/.claude/skills/skill-name/SKILL.md
+
+   # Project skills
+   ls .claude/skills/skill-name/SKILL.md
+   ```
+
+2. **Directory name matches frontmatter**
+   ```
+   Folder: skill-name/
+   Frontmatter: name: skill-name  # Must match exactly
+   ```
+
+3. **SKILL.md filename** (case-sensitive)
+   - Correct: `SKILL.md`
+   - Wrong: `skill.md`, `Skill.md`
+
+## YAML parsing errors
+
+**Symptoms**: Skill fails to load or behaves unexpectedly.
+
+**Check**:
+
+1. **No tabs in YAML** (spaces only)
+   ```yaml
+   # Wrong (tabs)
+   name:	skill-name
+
+   # Correct (spaces)
+   name: skill-name
+   ```
+
+2. **Frontmatter delimiters**
+   ```yaml
+   ---              # Line 1 (no blank lines before)
+   name: skill-name
+   description: ...
+   ---              # Closing delimiter
+
+   # Content starts here
+   ```
+
+3. **Validate YAML**
+   ```bash
+   head -n 10 SKILL.md
+   ```
+
+## Multiple Skills conflict
+
+**Symptoms**: Wrong Skill activates, or Skills interfere.
+
+**Solutions**:
+
+1. **Make descriptions more distinct**
+   ```yaml
+   # Skill A
+   description: Extract text from PDFs...
+
+   # Skill B
+   description: Create PDF reports from data...
+   ```
+
+2. **Use different trigger words**
+
+3. **Narrow scope of each Skill**
+   - One Skill = one capability
+   - Split broad Skills into focused ones
+
+## Skill has runtime errors
+
+**Symptoms**: Skill loads but fails during execution.
+
+**Check**:
+
+1. **Script permissions**
+   ```bash
+   chmod +x scripts/*.py
+   ```
+
+2. **Dependencies installed**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **File paths use forward slashes**
+   ```yaml
+   # Correct
+   python scripts/helper.py
+
+   # Wrong (Windows backslashes)
+   python scripts\helper.py
+   ```
+
+4. **Relative paths from skill directory**
+   ```yaml
+   # From SKILL.md, reference sibling files
+   See [examples.md](examples.md)
+   Run: python scripts/validate.py
+   ```
+
+## Debug mode
+
+Run Claude Code with debug output:
+
+```bash
+claude --debug
+```
+
+This shows:
+- Which Skills are loaded
+- Why Skills activate or don't
+- Any parsing errors
+
+## Common mistakes
+
+### 1. Name mismatch
+
+```
+Folder: my-skill/
+Frontmatter: name: myskill  # Wrong - doesn't match
+```
+
+### 2. Description too vague
+
+```yaml
+description: Utility for files  # Won't trigger
+```
+
+### 3. Missing "Use when" context
+
+```yaml
+# Missing context
+description: Extracts data from spreadsheets
+
+# Better
+description: Extracts data from spreadsheets. Use when working with Excel or CSV files.
+```
+
+### 4. Nested file references
+
+```markdown
+# Avoid deep nesting
+SKILL.md → advanced.md → details.md → more.md
+
+# Keep it flat
+SKILL.md → reference.md
+SKILL.md → examples.md
+```
+
+### 5. Tabs in YAML
+
+YAML requires spaces. Tabs cause silent failures.
+
+## Validation commands
+
+```bash
+# Check file exists
+ls .claude/skills/skill-name/SKILL.md
+
+# View frontmatter
+head -n 10 .claude/skills/skill-name/SKILL.md
+
+# Check for tabs (should return nothing)
+grep -P '\t' .claude/skills/skill-name/SKILL.md
+
+# Restart Claude to reload skills
+# (Exit and relaunch Claude Code)
+```

package/.claude/skills/smart-download-tagger/SKILL.md

@@ -0,0 +1,148 @@
+# SKILL: Smart Download & Tagger
+
+## Descrição
+Sistema inteligente de download, tagueamento e organização de materiais do Mega Brain.
+Lê a planilha de controle, identifica materiais pendentes, baixa do Drive, gera TAGs e atualiza a planilha.
+
+---
+
+## ESTRUTURA DA PLANILHA (PADRÃO ATUAL)
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  COLUNA  │  CONTEÚDO                                                         │
+├──────────────────────────────────────────────────────────────────────────────┤
+│  A       │  Módulo (número ou categoria)                                     │
+│  B       │  Número da Aula                                                   │
+│  C       │  Aula/Assunto/Tema (título descritivo)                           │
+│  D       │  Duração (mm:ss)                                                  │
+│  E       │  Link - Drive (URL ou nome do arquivo no Drive)                  │
+│  F       │  Link - YouTube (URL do vídeo no YouTube)                        │
+│  G       │  Transcrição (nome do arquivo .docx no Drive)                    │
+│  H       │  TAG (gerada por JARVIS - VAZIA = pendente)                      │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Regras da Planilha:
+1. **Cada linha = um conteúdo** (vídeo OU material complementar)
+2. **Materiais complementares** (PDFs, etc.) têm sua própria linha dedicada
+3. **Coluna H vazia** = material novo, não processado, precisa de download/TAG
+4. **Coluna H preenchida** = já processado e tagueado
+
+---
+
+## PREFIXOS DE TAG POR ABA
+
+| Aba | Prefixo TAG | Descrição |
+|-----|-------------|-----------|
+| Jeremy Miner | JM | Jeremy Miner Sales |
+| Jeremy Haynes Sales Training | JH-ST | Cursos JH |
+| Jeremy Haynes Inner Circle | JH-IC | Masterminds JH |
+| Inner Circle Weekly Group Call Recordings | JH-WK | Calls Semanais JH |
+| Agency Blueprint | AOBA | Cursos Agência |
+| Cold Video Pitch | PCVP | Cold Pitch |
+| Land Your First Agency Client | LYFC | Primeiro Cliente |
+| Marketer Mindset Masterclass | MMM | Mindset |
+| 30 Days Challenge | 30DC | Desafio 30 dias |
+| Scale The Agency | STA | Escala |
+| Ultra High Ticket Closer | UHTC | High Ticket |
+| The Scalable Company | TSC | Ryan Deiss |
+| Sales Training BR | EDC | Closer BR |
+| Alex Hormozi | AH | Hormozi |
+| Jeremy Haynes Program | CA | Sam Ovens |
+
+---
+
+## ALGORITMO DE PROCESSAMENTO
+
+```python
+def process_pending_materials():
+    """
+    1. Para cada aba da planilha:
+       a. Ler todas as linhas
+       b. Identificar linhas onde coluna H está VAZIA
+       c. Para cada linha pendente:
+          - Extrair nome do arquivo da coluna G (ou E para materiais)
+          - Buscar arquivo no Google Drive por nome
+          - Baixar conteúdo do arquivo
+          - Gerar TAG no formato: PREFIXO-XXXX
+          - Atualizar coluna H na planilha com a TAG
+          - Salvar arquivo no INBOX como: [TAG] nome_original.ext
+    """
+```
+
+---
+
+## FORMATO DE SAÍDA
+
+### Arquivo no INBOX
+```
+[TAG] Nome Original do Arquivo.ext
+
+Exemplos:
+[JM-0152] How to Handle Objections.txt
+[UHTC-0012] Module_5.m4a
+[CA-0032] 9 Figure Ad Scripts.pdf
+```
+
+### Atualização na Planilha
+- Coluna H recebe a TAG gerada
+- Formato: `PREFIXO-XXXX` (4 dígitos com zero à esquerda)
+
+---
+
+## TIPOS DE ARQUIVO SUPORTADOS
+
+| Tipo | Extensão | Ação |
+|------|----------|------|
+| Transcrição | .docx | Extrair texto, salvar como .txt |
+| PDF | .pdf | Baixar binário, manter formato |
+| Áudio | .mp3, .m4a | Baixar binário, manter formato |
+| Planilha | .xlsx | Baixar binário, manter formato |
+| Apresentação | .pptx | Baixar binário, manter formato |
+| Imagem | .jpeg, .jpg, .png | Baixar binário, manter formato |
+
+---
+
+## FERRAMENTAS MCP UTILIZADAS
+
+| Ferramenta | Uso |
+|------------|-----|
+| `mcp__gdrive__gsheets_read` | Ler planilha para identificar pendentes |
+| `mcp__gdrive__gdrive_search` | Buscar arquivos no Drive por nome |
+| `mcp__gdrive__gdrive_read_file` | Baixar conteúdo do arquivo |
+| `mcp__gdrive__gsheets_update_cell` | Atualizar TAG na coluna H |
+
+---
+
+## MAPEAMENTO DE DESTINO NO INBOX
+
+| Prefixo | Pasta Destino |
+|---------|---------------|
+| JM | JEREMY MINER/COURSES |
+| JH-ST, JH-IC, JH-WK, AOBA, PCVP, LYFC, MMM, 30DC, STA, UHTC | JEREMY HAYNES/COURSES |
+| TSC | THE SCALABLE COMPANY/COURSES |
+| EDC | COLE GORDON/COURSES |
+| AH | ALEX HORMOZI/COURSES |
+| CA | JEREMY HAYNES PROGRAM/COURSES |
+
+---
+
+## SCRIPT PRINCIPAL
+
+Localização: `scripts/smart-download-tagger.py`
+
+---
+
+## REGRAS IMPORTANTES
+
+1. **NUNCA duplicar** - verificar se arquivo já existe no INBOX antes de baixar
+2. **SEMPRE atualizar planilha** - TAG na coluna H após download bem-sucedido
+3. **MANTER consistência** - mesmo formato de TAG em todo o sistema
+4. **LOGS detalhados** - registrar cada ação para auditoria
+
+---
+
+**Skill criada em:** 2026-01-08
+**Autor:** JARVIS
+**Versão:** 1.0