=========================================================

KOKO SKILL SERIES

por Murilo Souza · koko.ag

Inteligência aplicada, empacotada para uso real.

=========================================================

Koko Reels Studio

Koko Reels Studio é uma skill/plugin para Claude Code que transforma conteúdo-fonte em um pacote de Reels pensado primeiro para Instagram.

Em vez de expor uma pipeline interna de curadoria, ela entrega um pacote claro para uso operacional:

• Pauta de Reels
• Banco de Ganchos
• Roteiros de Reels
• Guia de Edicao
• Pacote de Publicacao

Ela foi desenhada para estrategistas, editores e times de social media que já têm material bruto e querem transformar isso em ativos curtos reutilizáveis.

Visão Geral

Use esta skill quando você tiver uma transcrição, notas de vídeo, recortes de fala ou trechos de podcast e quiser transformar isso em um pacote de Reels com linguagem de execução.

O foco aqui não é despejar artefatos internos ou uma análise técnica crua. O foco é entregar algo que um estrategista, editor ou social media consiga usar rápido.

O Que Esta Skill Faz

• transforma material bruto em uma pauta de Reels utilizável
• organiza os melhores ganchos por força e contexto
• propõe roteiros de Reels com direção editorial
• entrega um guia de edição e um pacote de publicação

Para Quem Ela Foi Feita

• estrategistas de conteúdo
• social medias
• editores
• operadores de marketing
• founders que produzem conteúdo

Entradas Aceitas

As entradas ideais são:

• transcrição com timestamps
• recortes de fala com janelas de tempo
• notas de vídeo ou podcast
• trechos já garimpados de outro fluxo

Se faltarem timestamps, a skill continua útil, mas precisa reduzir a confiança e evitar fingir precisão de corte.

Saídas Esperadas

O contrato de saída padrão está em skills/koko-reels-studio/references/output-contract.md.

Por padrão, a skill entrega:

1. Pauta de Reels
2. Banco de Ganchos
3. Roteiros de Reels
4. Guia de Edicao
5. Pacote de Publicacao

Exports técnicos ou voltados para automação ficam em segundo plano.

Estrutura do Plugin

koko-reels-studio/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── koko-reels-studio/
│       ├── SKILL.md
│       ├── agents/openai.yaml
│       └── references/output-contract.md
├── examples/
│   ├── 01-input-transcript.md
│   ├── 01-output-reels-package.md
│   ├── 02-input-notes-only.md
│   └── 02-output-low-confidence.md
├── CHANGELOG.md
├── LICENSE
├── README-SKILL-TEMPLATE.pt-BR.md
└── README.md

Como Instalar Localmente

O Claude Code permite testar plugins localmente com --plugin-dir.

Referências oficiais:

• Create plugins: code.claude.com/docs/en/plugins
• Plugins reference: code.claude.com/docs/en/plugins-reference

1. Clone o repositório

git clone https://github.com/murilo-koko/koko-reels-studio.git
cd koko-reels-studio

2. Inicie o Claude Code com o plugin

claude --plugin-dir .

3. Recarregue após alterações

Dentro do Claude Code:

/reload-plugins

Como Usar

Este plugin expõe uma skill namespaced.

Invocação direta típica:

/koko-reels-studio:koko-reels-studio

Pedidos em linguagem natural também devem acionar a skill quando fizer sentido.

Prompts Recomendados

• Use $koko-reels-studio para transformar esta transcrição em um pacote de Reels
• Transforme esta reunião transcrita em 3 ideias de Reels para Instagram
• Use estes timestamps e me devolva ganchos, roteiros, notas de edição e direção de legenda
• Tenho esse trecho de podcast. Quero um pacote pronto de Reels no estilo Koko

Tutorial Rápido

Fluxo 1: Transcrição Com Timestamps

1. Ative o plugin no Claude Code.
2. Cole uma transcrição com timestamps.
3. Peça um pacote de Reels pensado para Instagram.
4. Revise as cinco entregas.
5. Escolha um roteiro e envie para edição ou publicação.

Prompt sugerido:

Use $koko-reels-studio para transformar esta transcrição em um pacote de Reels para Instagram.
Público: founders e operadores de marketing.
Objetivo: conteúdo prático e salvável.

[cole a transcrição aqui]

Resultado esperado:

• melhores ganchos ranqueados primeiro
• 3 a 5 conceitos de Reels distintos
• notas de edição
• orientação de legenda e publicação

Fluxo 2: Apenas Notas

1. Cole notas soltas ou highlights sem timestamp.
2. Peça conceitos, não cortes finais.
3. Confira a confiança indicada pela skill.
4. Use a saída como rascunho estratégico.

Prompt sugerido:

Use $koko-reels-studio apenas com estas notas.
Ainda não tenho timestamps.
Monte um pacote de Reels em versão rascunho e sinalize a confiança com clareza.

[cole as notas aqui]

Resultado esperado:

• confiança mais baixa
• nenhuma precisão de corte inventada
• ganchos e direções de Reels utilizáveis

Exemplos

Veja:

• examples/01-input-transcript.md
• examples/01-output-reels-package.md
• examples/02-input-notes-only.md
• examples/02-output-low-confidence.md

Diferenciais

• embalagem pronta para operação
• foco em Instagram e linguagem de execução
• saída clara para estrategista, editor e publicação

Esta skill evita depender, como entrega principal, de:

• jargão interno de framework
• YAML cru
• score técnico interno
• nomes internos de agentes

O usuário recebe algo pronto para usar, não algo que ainda precisa ser traduzido de uma pipeline interna.

Limites e Guardrails

• não inventa evidência quando faltam timestamps
• não finge que assistiu ao vídeo se só recebeu notas
• não trata rascunho como corte final quando faltam insumos

Sobre o Autor

Criado por Murilo Souza.

• Instagram: @murilo.sn
• LinkedIn: murilo-koko
• Koko: koko.ag

Publicação no GitHub

Se você quiser reaproveitar esse padrão para outras skills, use README-SKILL-TEMPLATE.pt-BR.md como base.

Se publicar novas skills como repositórios dedicados, a forma mais simples é manter o diretório da skill/plugin como raiz do repo.

Licença

Este projeto usa a licença MIT.