felvieira/zoom-out
skills/44-zoom-out/SKILL.md
Produz mapa de modulos e callers quando o agente esta perdido numa area de codigo desconhecida. Sobe uma camada de abstracao e da visao de bairro antes de tocar codigo. Use quando estiver unfamiliar com uma area, ao iniciar trabalho em modulo novo, ou quando o usuario pedir "visao geral", "mapa", "estou perdido", "como isso encaixa". Trigger em: "zoom out", "mapa de modulos", "mapa dos modulos", "estou perdido", "perdido nesse codigo", "como isso encaixa", "como se conecta", "callers principais", "visao geral", "big picture", "neighborhood", "broader context", "higher level perspective".
$ install --global
skillsauthnpx skillsauth add felvieira/claude-skills-fv zoom-outInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 28, 2026, 3:23 AM325.9s1 file scanned
SKILL.md
- name:
- zoom-out
- description:
- |
- Trigger em:
- zoom out", "mapa de modulos", "mapa dos modulos", "estou perdido", "perdido nesse codigo",
- argument-hint:
- [caminho-alvo] [--depth=2]
- allowed-tools:
- Read, Grep, Glob, Bash
Zoom Out — Mapa de Bairro Antes do Codigo
Inspiracao: mattpocock/skills/engineering/zoom-out (MIT). Adaptado: forca uso de
graphify-out/graph.jsonantes de Grep/Read brutos (CLAUDE.md global).
Quando Usar
- ao receber task em modulo que o agente nao conhece bem
- quando o usuario disse "estou perdido nessa parte"
- antes de propor refactor ou architecture change (input pra skill 38)
- antes de explorar com
GrepouReaddireto (mais economico) - como preludio de
detective-specem codigos legados
Quando NAO Usar
- voce ja conhece o modulo (zoom out vira ruido)
- task pontual em arquivo unico ja identificado
- bug fix com stack trace claro
Governanca Global
Esta skill segue GLOBAL.md, policies/code-exploration.md (graph > grep > read),
policies/token-efficiency.md (mapa enxuto, nao dump), policies/handoffs.md
(o mapa pode ser consumido por outras skills).
Protocolo
1. Tentar graph primeiro
Antes de qualquer Read/Grep, tentar:
test -f graphify-out/graph.json && echo "graph disponivel" || echo "sem graph"
Se graph existir, ler graphify-out/graph.json + graphify-out/GRAPH_REPORT.md (god nodes, communities). Isso responde 80% das perguntas de mapa.
2. Fallback: descoberta estrutural
Sem graph, descobrir estrutura via Glob:
# Topologia
find <alvo> -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.py" -o -name "*.go" -o -name "*.rs" \) | head -50
Identificar:
- entry points (index., main., app., cli.)
- agrupamentos por pasta (modulos logicos)
- arquivos grandes (provaveis hubs)
3. Mapear callers/callees principais
Para cada hub identificado, Grep por importacoes:
# Quem usa o modulo X?
rg "from ['\"].*<modulo-X>" --type ts --type tsx -l
4. Glossario do projeto
Antes de produzir output, capturar vocabulario do dominio lendo (em ordem de preferencia):
memory/constitution.md(se existir — termos canonicos)docs/repo-audit/current.md(audit)README.md(sintese)- Nomes de pastas/arquivos (fallback)
O mapa fala a lingua do projeto, nao termos genericos.
Output
Tabela markdown ou hierarquia textual:
# Mapa de <area>
## Vocabulario do dominio
- <termo>: <definicao curta>
## Arquitetura geral
<diagrama ASCII opcional — so se reduz complexidade>
## Modulos principais
| Modulo | Proposito | Callers principais | Callees principais |
|--------|-----------|-------------------|-------------------|
| ... | ... | ... | ... |
## God nodes (>X dependentes)
- <arquivo>: <numero> dependentes — provavel ponto de friccao
## Pendencias visiveis
- <TODO/FIXME publicos>
- <gaps documentacao>
Handoffs
- input pra skill 38 (architecture-deepener): mapa identifica god nodes; skill 38 propoe deepening
- input pra skill 33 (detective-spec): mapa orienta quais modulos detective deve cavar primeiro
- input pra skill 09 (orchestrator): mapa informa onde a feature toca, qual pipeline montar
- input pra skill 32 (smart-suggestions): dado o mapa, sugerir proxima acao concreta
Anti-padroes
- ❌ Dump completo de
find . -name "*.ts"— isso e fuga, nao mapa - ❌ Ler 50 arquivos pra entender 1 modulo — usa graph primeiro
- ❌ Mapa generico sem vocabulario do projeto
- ❌ "vou ler tudo e depois mapeio" — produz o mapa enquanto explora, nao depois
Related Skills
felvieira/po-feature-spec
testing
VerifiedTrustedCommunity
Skill do Product Owner para especificação de features. Use quando precisar definir requisitos de negócio, escrever user stories, critérios de aceitação, priorização de backlog, ou qualquer documento de especificação de produto. Inclui fundamento de negócio para discovery: validação de hipótese, problema vs. necessidade, MVP, modelo de monetização e métricas pirata (AARRR) como input da spec. Trigger em: "nova feature", "especificação", "user story", "requisito", "backlog", "PO", "definir escopo", "critério de aceitação", "MVP", "roadmap", "validação de hipótese", "discovery", "monetização", "pricing", "product-market fit", "métricas AARRR".
20SKILL.mdUpdated Apr 4, 2026
felvieira/41-blog-publisher
development
VerifiedTrustedCommunity
Skill compositora que pega texto/assunto e gera post de blog HTML completo no repo {blog_repo_path} ({github_user_repo_url}), com imagens (via skill 17 fal.ai ou skill 42 Playwright screenshot), commit+push automático, retorna URL pública via GitHub Pages. Trigger em: "post no blog", "publicar post", "escrever post", "blog post", "publish blog", "gera post", "criar post", "novo post no meu blog".
19SKILL.mdUpdated May 25, 2026
felvieira/context-budget
tools
VerifiedTrustedCommunity
Audita o peso de contexto carregado na sessão — CLAUDE.md, agents, MCP descriptions, rules ativas, skills invocadas e histórico acumulado. Estima tokens por componente, reporta headroom disponível e emite alertas de overflow. Distinto do cost-tracker (skill 30) que rastreia tokens gastos em completions runtime. Trigger em: "contexto inchado", "context overflow", "quanto contexto estou usando", "peso do contexto", "context budget", "tokens carregados", "sessao lenta", "respostas degradadas", "headroom de contexto", "custo fixo de contexto", "overhead de rules", "overhead dos agents", "impacto do MCP no contexto", "espaco no context window", "quanto cabe no context window"
18SKILL.mdUpdated May 29, 2026
felvieira/research-prep
development
VerifiedTrustedCommunity
Coleta e organiza informacao tecnica multi-fonte antes de escrever docs, PRDs, ADRs ou artigos. Busca em: docs oficiais, GitHub (repos + issues), Stack Overflow, papers e blogs de referencia. Ranqueia fontes por autoridade (oficial 40% + recencia 30% + profundidade 20% + comunidade 10%). Output: memory/research/<slug>.md pronto para alimentar skill 10 (documenter), skill 01 (po-feature-spec), skill 26 (prompt-engineer) ou skill 41 (blog-publisher). Trigger em: "pesquisa tecnica", "levanta informacao", "coleta docs", "busca referencias", "preciso de fontes", "research antes de escrever", "levanta o que existe sobre", "benchmark de solucoes", "o que existe sobre X", "quero entender o estado da arte", "compara abordagens", "levanta referencias", "faz um research de", "coleta fontes sobre", "pesquisa sobre", "quero saber o que existe de", "monta um dossie tecnico", "background tecnico", "due diligence tecnica", "levantamento de alternativas".
18SKILL.mdUpdated May 29, 2026