Skip to content
Back to search

sonoplasta

MarketplaceWorks with Claude CodeGitHub

Skills de áudio para o Claude: engenharia de som, mixagem, masterização e loudness.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jvillalaz--sonoplasta/badge.svg)](/listings/jvillalaz--sonoplasta)

HTML

<a href="/listings/jvillalaz--sonoplasta"><img src="/api/listings/jvillalaz--sonoplasta/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "sonoplasta",
  3. "description": "Skills de áudio para o Claude: engenharia de som, mixagem, masterização e loudness.",
  4. "owner": {
  5. "name": "Jimmy"
  6. },
  7. "plugins": [
  8. {
  9. "name": "sonoplasta",
  10. "source": "./plugins/sonoplasta",
  11. "license": "MIT",
  12. "description": "Engenheiro de áudio sênior e produtor musical: captação, voz para vídeo, mixagem estéreo e Dolby Atmos, masterização, loudness, diagnóstico de áudio, limpeza de fala (silêncios e vícios) e entregas para YouTube, Instagram Reels, TikTok, criadores de conteúdo, redes sociais, TV, comerciais e discos."
  13. }
  14. ]
  15. }
README.md · README · 261 lines
  1. <p align="center">
  2. <img src="docs/icone.svg" width="128" height="128" alt="Ícone da sonoplasta: três faders de mesa de som sobre uma onda sonora">
  3. </p>
  4. <h1 align="center">Sonoplasta</h1>
  5. <p align="center">
  6. <b>Um engenheiro de áudio sênior e produtor musical dentro do Claude.</b>
  7. </p>
  8. <p align="center">
  9. Captação, voz para vídeo, mixagem estéreo e Dolby Atmos, masterização, loudness e entregas para
  10. YouTube, Instagram Reels, TikTok, podcast, TV, comerciais e discos. Responde em português do
  11. Brasil, com valores de partida concretos, e no Claude Code também mede e corrige os seus
  12. arquivos com ffmpeg.
  13. </p>
  14. <p align="center">
  15. <a href="https://github.com/jvillalaz/sonoplasta/releases/latest"><img alt="Versão" src="https://img.shields.io/github/v/release/jvillalaz/sonoplasta?style=flat-square&label=vers%C3%A3o&color=0b7385"></a>
  16. <img alt="Claude Code e claude.ai" src="https://img.shields.io/badge/Claude%20Code%20%C2%B7%20claude.ai-skill-d97757?style=flat-square">
  17. <img alt="Idioma: português do Brasil" src="https://img.shields.io/badge/idioma-pt--BR-2bb3a3?style=flat-square">
  18. <img alt="Scripts com ffmpeg" src="https://img.shields.io/badge/scripts-ffmpeg%20%C2%B7%20bash-16324f?style=flat-square&logo=ffmpeg">
  19. <a href="LICENSE"><img alt="Licença: MIT" src="https://img.shields.io/badge/licen%C3%A7a-MIT-blue?style=flat-square"></a>
  20. </p>
  21. <p align="center">
  22. <a href="#o-que-faz">O que faz</a> ·
  23. <a href="#recursos">Recursos</a> ·
  24. <a href="#instalar">Instalar</a> ·
  25. <a href="#como-usar">Como usar</a> ·
  26. <a href="#scripts">Scripts</a> ·
  27. <a href="#seus-presets">Seus presets</a> ·
  28. <a href="#como-%C3%A9-feita">Como é feita</a> ·
  29. <a href="#vers%C3%B5es">Versões</a> ·
  30. <a href="#licen%C3%A7a-e-cr%C3%A9ditos">Licença</a>
  31. </p>
  32. ## O que faz
  33. Você descreve o problema do jeito que fala com um técnico de som, e a sonoplasta responde como um:
  34. começa pela causa mais provável, dá a ordem de trabalho e os valores de partida (frequência, ratio,
  35. attack/release, LUFS, true peak) e separa o que é especificação oficial do que é prática comum.
  36. <table>
  37. <tr>
  38. <td width="50%" valign="top">
  39. **Você pergunta**
  40. > Estou mixando uma música pop com voz, violão, piano, baixo e bateria. A mix está embolada e a voz
  41. > não aparece, mesmo alta. Uso Reaper.
  42. **A sonoplasta responde** (trecho)
  43. > Voz alta que não aparece quase sempre é mascaramento em 200 a 500 Hz e em 2 a 5 kHz, e muitas
  44. > vezes começa no arranjo [...]
  45. >
  46. > 2. **HPF em tudo que não é grave:** violão a 120 a 150 Hz, piano a 100 a 150 Hz, voz a 80 a
  47. > 100 Hz.
  48. > 3. **Lama:** corte de 2 a 4 dB entre 250 e 400 Hz no violão e no piano (Q por volta de 1).
  49. > 4. **Espaço para a voz:** EQ dinâmica em 2 a 4 kHz no bus de violão e piano, com sidechain da voz.
  50. >
  51. > No Reaper, o ReaEQ não tem banda dinâmica. Use o ReaXcomp em uma faixa [...]
  52. </td>
  53. <td width="50%" valign="top">
  54. **Você pergunta**
  55. > Uma agência pediu o áudio de um comercial de 30 segundos para TV aberta no Brasil. O que preciso
  56. > entregar?
  57. **A sonoplasta responde** (trecho)
  58. > O primeiro passo é pedir à agência o manual técnico de recebimento da emissora [...]
  59. >
  60. > ```
  61. > FICHA DE ENTREGA: comercial 30 s / TV aberta (Brasil)
  62. > - Loudness integrado: conforme ABNT NBR 16313 e
  63. > emissora; referência de mercado −23 LKFS
  64. > (prática comum)
  65. > - Sample rate: 48 kHz
  66. > - Bit depth / codec: 24 bits PCM
  67. > - Versões e stems: mix completa, versão sem
  68. > locução, trilha e efeitos separados
  69. > - Confirmar com: manual técnico da emissora
  70. > ```
  71. </td>
  72. </tr>
  73. </table>
  74. <sub>Trechos dos modelos de resposta em <a href="plugins/sonoplasta/skills/sonoplasta/exemplos.md"><code>exemplos.md</code></a>, que calibram o formato e o nível de detalhe da skill.</sub>
  75. ## Recursos
  76. | Recurso | Onde funciona |
  77. |---|---|
  78. | **Orientação técnica:** cadeias por fonte (voz, violão, bateria, baixo), frequências, compressão, mixagem estéreo e Atmos, masterização | claude.ai e Claude Code |
  79. | **Entregas:** fichas por destino (YouTube, Reels, TikTok, Spotify, podcast, TV, comerciais, Atmos, CD e vinil) e codecs com comandos de conversão | claude.ai e Claude Code |
  80. | **Modos de trabalho:** separa captação, edição, mixagem, masterização e entrega, e avisa quando o problema nasceu numa etapa anterior | claude.ai e Claude Code |
  81. | **Troubleshooting:** roteiros para voz abafada, sibilância, ruído de fundo, mix embolada, grave que some no celular e outros | claude.ai e Claude Code |
  82. | **Contexto brasileiro:** gospel e worship, coral, sertanejo, MPB, funk e podcast em vídeo | claude.ai e Claude Code |
  83. | **Seus presets:** usa seus plugins, cadeias e alvos | claude.ai (colando) e Claude Code |
  84. | **Diagnóstico de arquivos:** loudness, true peak, clipping, DC offset, silêncios e compatibilidade mono, com resumo do que está bom e do que precisa de atenção | Claude Code |
  85. | **Normalização:** loudnorm em duas passadas e exportação pronta para Reels, sem recodificar o vídeo | Claude Code |
  86. | **Limpeza de fala:** propõe cortes de silêncios, "ãh", "né" e repetições, e só aplica depois da sua aprovação | Claude Code |
  87. ### Por área
  88. - **Captação:** escolha e posição de microfone, ganho, sala, fase entre microfones e room tone.
  89. - **Voz para vídeo:** lapela e shotgun, redução de ruído sem artefatos, ducking da trilha e edição de
  90. fala (silêncios, emendas, respiração).
  91. - **Mixagem:** HPF e mascaramento por faixa de frequência, compressão em série, buses, envios de
  92. reverb e delay, pan e conferência em mono e em referência.
  93. - **Dolby Atmos:** beds e objetos, binaural e entrega.
  94. - **Masterização:** cadeia, limiter, true peak, dither e versões por destino.
  95. - **Loudness e medição:** LUFS integrado, short-term e momentary, LRA, true peak e como cada
  96. plataforma normaliza.
  97. - **Entregas:** fichas com loudness, formato, sample rate, canais, stems e o que confirmar com quem
  98. recebe, para streaming, redes sociais, TV, comerciais, CD e vinil.
  99. Valores de loudness e especificações de plataformas mudam: a skill sempre indica onde confirmar na
  100. documentação oficial.
  101. ## Instalar
  102. ### Claude Code
  103. ```
  104. /plugin marketplace add jvillalaz/sonoplasta
  105. /plugin install sonoplasta@sonoplasta
  106. ```
  107. A skill entra sozinha quando o assunto for áudio. Também dá para chamar direto com
  108. `/sonoplasta:sonoplasta`. Para atualizar: `/plugin marketplace update sonoplasta`.
  109. ### claude.ai (navegador ou app)
  110. 1. Baixe o `sonoplasta.zip` da [versão mais recente](https://github.com/jvillalaz/sonoplasta/releases/latest).
  111. 2. Abra **Customize > Skills** e clique em **+ > Create skill > Upload a skill**.
  112. 3. Envie o ZIP.
  113. No claude.ai a skill orienta, mas não roda os scripts. Para medir um arquivo, use o seu medidor de
  114. loudness (ex.: Youlean Loudness Meter) e passe os valores na conversa.
  115. ## Como usar
  116. Exemplos de pedidos:
  117. - "Minha voz no YouTube está abafada. Gravo com um SM7B numa sala sem tratamento."
  118. - "Quais as especificações de entrega para um comercial de TV?"
  119. - "Analisa o áudio desse vídeo antes de eu postar." (Claude Code, com o arquivo na pasta)
  120. - "Deixa esse vídeo pronto para o Reels." (Claude Code)
  121. - "Tira os silêncios e os 'ãh' desse vídeo." (Claude Code; os cortes só são aplicados depois que você
  122. aprovar o relatório)
  123. Quanto mais contexto, melhor a resposta: destino (YouTube, TV, Spotify), equipamento, DAW ou editor
  124. e o que você já tentou.
  125. ## Scripts
  126. No Claude Code, a skill roda os scripts sozinha quando há um arquivo na pasta. Eles também podem ser
  127. rodados à mão, a partir da pasta da skill:
  128. ```bash
  129. bash scripts/diagnosticar.sh video.mp4 --alvo -14 # diagnóstico completo
  130. bash scripts/normalizar.sh episodio.wav -16 # normaliza para -16 LUFS
  131. bash scripts/preparar-reels.sh video.mp4 # -14 LUFS, -1,5 dBTP, AAC 48 kHz
  132. ```
  133. | Script | O que faz |
  134. |---|---|
  135. | `preflight.sh` | Confere container, trilhas e sample rate, e avisa sobre áudio ausente, canal vazio e saída insegura |
  136. | `diagnosticar.sh` | Preflight, loudness, clipping, DC offset, silêncios e mono, com resumo "bom / atenção" |
  137. | `medir.sh` | Loudness integrado, LRA e true peak |
  138. | `checar-mono.sh` | Compatibilidade mono e correlação entre canais |
  139. | `normalizar.sh` | Loudnorm em duas passadas para o alvo pedido, respeitando o true peak |
  140. | `preparar-reels.sh` | Normaliza e exporta em AAC 48 kHz com o vídeo copiado |
  141. | `limpar-fala/` | Transcreve, propõe cortes e aplica só com `--aprovado` |
  142. ### Requisitos
  143. Só a orientação não precisa de nada. Para os scripts:
  144. | Para | Precisa de | Como instalar |
  145. |---|---|---|
  146. | Diagnóstico, medição, normalização e Reels | `ffmpeg` (com `ffprobe`) e `bash` | Windows: `winget install --id Gyan.FFmpeg` e Git Bash · macOS: `brew install ffmpeg` · Linux: `sudo apt install ffmpeg` |
  147. | Limpeza de fala | Python 3 e [faster-whisper](https://github.com/SYSTRAN/faster-whisper) | `pip install faster-whisper` (no Windows: `py -m pip install faster-whisper`) |
  148. A transcrição roda no seu computador: o áudio não é enviado para nenhum serviço. Na primeira vez, a
  149. faster-whisper baixa o modelo (cerca de 500 MB).
  150. Detalhes de cada script em [`referencias/scripts.md`](plugins/sonoplasta/skills/sonoplasta/referencias/scripts.md)
  151. e da limpeza de fala em [`referencias/limpar-fala.md`](plugins/sonoplasta/skills/sonoplasta/referencias/limpar-fala.md).
  152. ## Seus presets
  153. Para a skill usar seus plugins, suas cadeias e seus alvos:
  154. 1. Copie o [modelo](plugins/sonoplasta/skills/sonoplasta/modelos/sonoplasta-presets.md) para a pasta
  155. do seu projeto com o nome `sonoplasta-presets.md`.
  156. 2. Preencha só o que quiser. O que você não definir continua vindo dos presets genéricos.
  157. No Claude Code, a skill procura esse arquivo só na pasta de trabalho, nunca em pastas pessoais. No
  158. claude.ai, cole o conteúdo na conversa. Os avisos de segurança e as especificações oficiais continuam
  159. valendo mesmo com presets próprios.
  160. ## Como é feita
  161. O `SKILL.md` é um índice curto com a persona e os passos de trabalho; o conhecimento de cada assunto
  162. fica em `referencias/` e só é lido quando o pedido precisa dele.
  163. ```
  164. .claude-plugin/marketplace.json catálogo (permite /plugin marketplace add)
  165. plugins/sonoplasta/
  166. ├── .claude-plugin/plugin.json manifesto e versão do plugin
  167. └── skills/sonoplasta/ conteúdo da skill (é o que vai no ZIP)
  168. ├── SKILL.md persona, passos e índice
  169. ├── referencias/ conhecimento detalhado por assunto
  170. ├── scripts/ diagnóstico, medição, normalização, Reels e limpeza de fala
  171. ├── modelos/ modelo de presets do usuário
  172. ├── glossario.md termos técnicos
  173. ├── exemplos.md modelos de resposta
  174. └── LICENCAS-TERCEIROS.md avisos de licença das fontes
  175. docs/icone.svg ícone do projeto
  176. scripts/empacotar.sh gera o ZIP para o claude.ai
  177. testes.md perguntas para revisar a skill antes de cada versão
  178. FONTES.md fontes externas, licenças e o que foi aproveitado
  179. CHANGELOG.md mudanças de cada versão
  180. ```
  181. ### Desenvolvimento
  182. - Ao criar um arquivo em `referencias/`, adicione-o ao índice do `SKILL.md`.
  183. - Testes dos scripts: `bash plugins/sonoplasta/skills/sonoplasta/scripts/testes/rodar-testes.sh`
  184. (gera sinais de teste e confere todos os scripts).
  185. - Antes de cada versão, revise as respostas da skill para as perguntas de [`testes.md`](testes.md).
  186. - Ao mudar algo relevante, suba a `version` em `plugins/sonoplasta/.claude-plugin/plugin.json`,
  187. registre no [`CHANGELOG.md`](CHANGELOG.md) e valide com `claude plugin validate .`.
  188. - Gere o ZIP com `./scripts/empacotar.sh` (sai em `dist/`, que não vai para o git).
  189. As regras de edição para o Claude Code estão no [`CLAUDE.md`](CLAUDE.md). Sugestões e problemas são
  190. bem-vindos nas [issues](https://github.com/jvillalaz/sonoplasta/issues).
  191. ## Versões
  192. A [versão mais recente](https://github.com/jvillalaz/sonoplasta/releases/latest) traz o
  193. `sonoplasta.zip` para o claude.ai, e [todas as versões](https://github.com/jvillalaz/sonoplasta/releases),
  194. da 1.0.0 em diante, têm as notas de cada uma. O histórico completo está no
  195. [`CHANGELOG.md`](CHANGELOG.md).
  196. ## Licença e créditos
  197. A sonoplasta é distribuída sob a [licença MIT](LICENSE).
  198. A versão 2.0 aproveita ideias de outras skills de áudio de código aberto, todas reescritas em
  199. português e adaptadas ao padrão da sonoplasta. O levantamento, as licenças e o que entrou de cada uma
  200. estão em [`FONTES.md`](FONTES.md). Os avisos de licença exigidos (MIT e Apache-2.0) estão em
  201. [`LICENCAS-TERCEIROS.md`](plugins/sonoplasta/skills/sonoplasta/LICENCAS-TERCEIROS.md), que também vai
  202. dentro do ZIP.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.