# felpborges/skill-reel architecture

> Architecture diagram of the GitHub repository felpborges/skill-reel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/felpborges/skill-reel
- Repository: https://github.com/felpborges/skill-reel

## Overview

O produto é uma skill do Claude Code que transforma uma gravação falada em um reel vertical editado e verificado. O fluxo principal é corte editorial e conferência, seguido de preparação/transcrição, enquadramento e composição VSL, renderização e validação final. O README documenta a sequência; os trechos de código confirmam parte do processamento de áudio, transcrição e composição, mas não cobrem todas as ligações internas. Portanto, as relações não mostradas diretamente são sustentadas apenas quando o README explicita o fluxo.

Main entry points: [`modelo/montar.mjs`](https://github.com/felpborges/skill-reel/blob/main/modelo/montar.mjs) (Montagem da composição), [`corte/scripts/comum.py`](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/comum.py) (Áudio e transcrição), [`SKILL.md`](https://github.com/felpborges/skill-reel/blob/main/SKILL.md) (Fluxo da skill), [`corte/scripts/1-tomadas.py`](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/1-tomadas.py) (Mapa de tomadas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Skill e fluxo"]
  node_skill["Fluxo da skill<br/>[SKILL.md]"]
end

subgraph group_cut["Corte editorial"]
  node_checker["Checagem de requisitos<br/>[0-checar.py]"]
  node_audio_common["Áudio e transcrição<br/>[comum.py]"]
  node_takes["Mapa de tomadas<br/>[1-tomadas.py]"]
  node_keeps["Escolha de keeps"]
  node_vices["Transcrição de vícios<br/>[2-vicios.py]"]
  node_cut_engine["Motor de corte<br/>[3-corte.py]"]
  node_remap["Remapeamento temporal<br/>[remapear.py]"]
  node_review["Conferência do corte<br/>[4-conferir.py]"]
end

subgraph group_prep["Preparação e enquadramento"]
  node_prepare["Mídia e transcrição<br/>[preparar.py]"]
  node_face_track["Rastreio da boca<br/>[rastrear-boca.py]"]
  node_framing["Enquadramento e rosto<br/>[rosto.py]"]
end

subgraph group_composition["Composição VSL"]
  node_beats["Mapa de beats<br/>[beats-exemplo.js]"]
  node_composer["Montagem da composição<br/>[montar.mjs]"]
  node_motion_kit["Kit de motion VSL<br/>[kit.js]"]
  node_illustrations["Ilustrações de interface"]
end

subgraph group_delivery["Render e validação"]
  node_audio_final["Mixagem final<br/>[audio-final.sh]"]
  node_safe_zone["Validação da zona segura<br/>[zona-segura.py]"]
  node_verify["Verificação do reel<br/>[verificar.py]"]
  node_video["Reel MP4"]
end

node_user(("Pessoa usuária"))

node_user -->|"envia vídeo"| node_skill
node_skill -->|"verifica requisitos"| node_checker
node_skill -->|"inicia corte"| node_takes
node_checker -->|"consulta recursos"| node_audio_common
node_takes -->|"usa áudio e transcrição"| node_audio_common
node_takes -->|"informa escolha"| node_keeps
node_keeps -->|"orienta transcrição"| node_vices
node_vices -->|"usa recorte e palavras"| node_audio_common
node_vices -->|"fornece palavras"| node_cut_engine
node_cut_engine -.->|"remapeia tempos"| node_remap
node_cut_engine -->|"gera corte"| node_review
node_review -->|"transcreve emendas"| node_audio_common
node_review -->|"fornece mídia limpa e palavras"| node_prepare
node_prepare -->|"prepara rastreio"| node_face_track
node_prepare -->|"prepara enquadramento"| node_framing
node_face_track -->|"fornece rastreio"| node_composer
node_framing -->|"fornece configuração"| node_composer
node_beats -->|"define cenas"| node_composer
node_composer -->|"incorpora kit"| node_motion_kit
node_illustrations -.->|"fornece imagens"| node_composer
node_composer -->|"produz composição"| node_audio_final
node_audio_final -->|"fornece render"| node_safe_zone
node_safe_zone -->|"valida zona segura"| node_verify
node_verify -->|"entrega verificada"| node_video

click node_skill "https://github.com/felpborges/skill-reel/blob/main/SKILL.md"
click node_checker "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/0-checar.py"
click node_audio_common "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/comum.py"
click node_takes "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/1-tomadas.py"
click node_keeps "https://github.com/felpborges/skill-reel/tree/main/corte"
click node_vices "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/2-vicios.py"
click node_cut_engine "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/3-corte.py"
click node_remap "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/remapear.py"
click node_review "https://github.com/felpborges/skill-reel/blob/main/corte/scripts/4-conferir.py"
click node_prepare "https://github.com/felpborges/skill-reel/blob/main/ferramentas/preparar.py"
click node_face_track "https://github.com/felpborges/skill-reel/blob/main/modelo/ferramentas/rastrear-boca.py"
click node_framing "https://github.com/felpborges/skill-reel/blob/main/ferramentas/rosto.py"
click node_beats "https://github.com/felpborges/skill-reel/blob/main/modelo/exemplo/beats-exemplo.js"
click node_composer "https://github.com/felpborges/skill-reel/blob/main/modelo/montar.mjs"
click node_motion_kit "https://github.com/felpborges/skill-reel/blob/main/modelo/kit/kit.js"
click node_illustrations "https://github.com/felpborges/skill-reel/tree/main/modelo/ferramentas/ilustracoes"
click node_audio_final "https://github.com/felpborges/skill-reel/blob/main/ferramentas/audio-final.sh"
click node_safe_zone "https://github.com/felpborges/skill-reel/blob/main/ferramentas/zona-segura.py"
click node_verify "https://github.com/felpborges/skill-reel/blob/main/ferramentas/verificar.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill toneBlue
class node_checker,node_audio_common,node_takes,node_keeps,node_vices,node_cut_engine,node_remap,node_review toneAmber
class node_prepare,node_face_track,node_framing toneMint
class node_beats,node_composer,node_motion_kit,node_illustrations toneRose
class node_audio_final,node_safe_zone,node_verify,node_video,node_user toneIndigo
```

## Components

### Skill e fluxo

- [Fluxo da skill](https://github.com/felpborges/skill-reel/blob/main/SKILL.md): `SKILL.md`

### Corte editorial

- [Checagem de requisitos](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/0-checar.py): `corte/scripts/0-checar.py`
- [Áudio e transcrição](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/comum.py): `corte/scripts/comum.py`
- [Mapa de tomadas](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/1-tomadas.py): `corte/scripts/1-tomadas.py`
- [Escolha de keeps](https://github.com/felpborges/skill-reel/tree/main/corte): `corte`
- [Transcrição de vícios](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/2-vicios.py): `corte/scripts/2-vicios.py`
- [Motor de corte](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/3-corte.py): `corte/scripts/3-corte.py`
- [Remapeamento temporal](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/remapear.py): `corte/scripts/remapear.py`
- [Conferência do corte](https://github.com/felpborges/skill-reel/blob/main/corte/scripts/4-conferir.py): `corte/scripts/4-conferir.py`

### Preparação e enquadramento

- [Mídia e transcrição](https://github.com/felpborges/skill-reel/blob/main/ferramentas/preparar.py): `ferramentas/preparar.py`
- [Rastreio da boca](https://github.com/felpborges/skill-reel/blob/main/modelo/ferramentas/rastrear-boca.py): `modelo/ferramentas/rastrear-boca.py`
- [Enquadramento e rosto](https://github.com/felpborges/skill-reel/blob/main/ferramentas/rosto.py): `ferramentas/rosto.py`

### Composição VSL

- [Mapa de beats](https://github.com/felpborges/skill-reel/blob/main/modelo/exemplo/beats-exemplo.js): `modelo/exemplo/beats-exemplo.js`
- [Montagem da composição](https://github.com/felpborges/skill-reel/blob/main/modelo/montar.mjs): `modelo/montar.mjs`
- [Kit de motion VSL](https://github.com/felpborges/skill-reel/blob/main/modelo/kit/kit.js): `modelo/kit/kit.js`
- [Ilustrações de interface](https://github.com/felpborges/skill-reel/tree/main/modelo/ferramentas/ilustracoes): `modelo/ferramentas/ilustracoes`

### Render e validação

- [Mixagem final](https://github.com/felpborges/skill-reel/blob/main/ferramentas/audio-final.sh): `ferramentas/audio-final.sh`
- [Validação da zona segura](https://github.com/felpborges/skill-reel/blob/main/ferramentas/zona-segura.py): `ferramentas/zona-segura.py`
- [Verificação do reel](https://github.com/felpborges/skill-reel/blob/main/ferramentas/verificar.py): `ferramentas/verificar.py`
- **Reel MP4**

### Other components

- **Pessoa usuária**

## Connections

- Pessoa usuária → Fluxo da skill: envia vídeo (evidence: `README.md`)
- Fluxo da skill → Checagem de requisitos: verifica requisitos (evidence: `README.md`)
- Fluxo da skill → Mapa de tomadas: inicia corte (evidence: `README.md`)
- Checagem de requisitos → Áudio e transcrição: consulta recursos (evidence: `corte/scripts/0-checar.py`)
- Mapa de tomadas → Áudio e transcrição: usa áudio e transcrição (evidence: `corte/scripts/1-tomadas.py`)
- Mapa de tomadas → Escolha de keeps: informa escolha (evidence: `README.md`)
- Escolha de keeps → Transcrição de vícios: orienta transcrição (evidence: `corte/scripts/2-vicios.py`)
- Transcrição de vícios → Áudio e transcrição: usa recorte e palavras (evidence: `corte/scripts/2-vicios.py`)
- Transcrição de vícios → Motor de corte: fornece palavras (evidence: `README.md`)
- Motor de corte → Remapeamento temporal: remapeia tempos
- Motor de corte → Conferência do corte: gera corte (evidence: `README.md`)
- Conferência do corte → Áudio e transcrição: transcreve emendas (evidence: `corte/scripts/4-conferir.py`)
- Conferência do corte → Mídia e transcrição: fornece mídia limpa e palavras (evidence: `README.md`)
- Mídia e transcrição → Rastreio da boca: prepara rastreio (evidence: `README.md`)
- Mídia e transcrição → Enquadramento e rosto: prepara enquadramento (evidence: `README.md`)
- Rastreio da boca → Montagem da composição: fornece rastreio (evidence: `README.md`)
- Enquadramento e rosto → Montagem da composição: fornece configuração (evidence: `README.md`)
- Mapa de beats → Montagem da composição: define cenas (evidence: `README.md`)
- Montagem da composição → Kit de motion VSL: incorpora kit (evidence: `modelo/montar.mjs`)
- Ilustrações de interface → Montagem da composição: fornece imagens
- Montagem da composição → Mixagem final: produz composição (evidence: `README.md`)
- Mixagem final → Validação da zona segura: fornece render (evidence: `README.md`)
- Validação da zona segura → Verificação do reel: valida zona segura (evidence: `README.md`)
- Verificação do reel → Reel MP4: entrega verificada (evidence: `README.md`)
