CommunityEscrita e Ediçãogithub.com

revisão-de-roteiros

Executa uma página local no navegador onde um revisor analisa um roteiro linha por linha, comenta sobre linhas ou palavras selecionadas, edita linhas diretamente e envia as anotações de volta ao agente, que revisa o arquivo markdown. Use quando o usuário quiser revisar, comentar ou aprovar um rascunho de roteiro no navegador, pedir a página do roteiro ou sua lista, quiser o roteiro no celular ou teleprompter, ou após redigir um roteiro que precise de revisão.

O que é revisão-de-roteiros?

Esta skill transforma a revisão de roteiros em um fluxo interativo e contínuo entre você (o agente de IA) e um revisor humano, usando apenas um navegador local. Cada roteiro é um arquivo markdown; você salva o roteiro, o revisor lê cada linha em uma página web local, faz comentários ou edições diretamente na página e envia as anotações. Você recebe essas anotações como markdown, aplica as mudanças mínimas necessárias e repete o ciclo até que o revisor aprove com "Looks good." É útil para qualquer desenvolvedor ou criador que precise de um processo de aprovação claro e rastreável para roteiros de vídeos, apresentações ou conteúdo falado. A skill é executada via linha de comando com Python 3.9+ (sem pacotes extras) e suporta comandos para criar, listar, aguardar anotações e alterar status dos roteiros. O fluxo é especialmente adequado para ambientes como Claude Code, Cursor, Codex ou qualquer terminal que possa executar scripts Python e abrir páginas web locais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kjmagnan1s/reviewing-scripts/tree/main/skills/reviewing-scripts

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Revisão de roteiros

Cada roteiro é um arquivo markdown. O revisor o lê em uma página local, e suas anotações voltam para você como markdown. Todos os comandos são python3 scripts/script_review.py <comando>, com o caminho relativo à pasta desta skill. Python 3.9 ou superior, nenhum pacote para instalar.

O ciclo de revisão

  1. Salve o roteiro. Escreva o corpo em um arquivo temporário e execute script_review.py new --title "<título>" --body-file <arquivo> --status drafted. Ele imprime o id do roteiro, o caminho do arquivo e o endereço da página. Coloque uma frase ou batida em cada linha da leitura, para que cada linha possa receber seu próprio comentário.
  2. Inicie a página. Execute script_review.py up, depois script_review.py open <id>. Forneça ao revisor o endereço.
  3. Aguarde as anotações. Execute script_review.py wait <id> em segundo plano. Ele imprime as anotações quando o revisor clicar em Enviar anotações e sai com código 2 após duas horas sem envio.
  4. Aplique as anotações. Edite o arquivo do roteiro com a menor alteração que responda a cada anotação. A página aberta recarrega-se e marca as linhas que mudaram.
  5. Repita a partir do passo 3 até que as anotações digam "Looks good." Esse envio também move um rascunho para o status aprovado.

Se você não estava esperando quando as anotações foram enviadas, script_review.py inbox imprime todo conjunto não lido.

Regras para revisão

  • Mantenha as edições do revisor palavra por palavra. Linhas listadas em "edições (já salvas no arquivo)" são suas próprias palavras e já estão no arquivo antes de você ver as anotações. Altere uma apenas quando uma anotação pedir.
  • Altere apenas o que uma anotação cobre. Não reescreva linhas que não têm comentário.
  • Aplique "Edições que não chegaram" manualmente. A linha foi movida antes do envio, então o arquivo não foi alterado.
  • Deixe chaves do frontmatter que você não definiu. Altere o status com script_review.py status <id> <status>, não editando o arquivo.
  • Não exclua um arquivo de roteiro a menos que o revisor peça.

O formato do arquivo

---
type: script
id: 2026-01-15-three-prompt-habits
title: Três hábitos de prompt
status: drafted
---

## Roteiro Falado

Sua primeira linha, uma frase por linha.
A segunda linha.

## Aberturas alternativas

Abertura 2 (pergunta): Uma segunda linha de abertura para filmar.

## Legenda

Qualquer outra coisa que você mantenha com o roteiro.

Cópia de leitura na página copia a seção Roteiro Falado como um parágrafo, depois cada abertura alternativa de abertura 2 em diante como "Dois. ". Um arquivo sem seção Roteiro Falado é lido por inteiro. script_review.py read <id> imprime o mesmo texto.

Outros comandos

  • list [--status <status>] [--json]: cada roteiro com seu status e contagem de palavras.
  • status <id> <status>: define um status (idea, drafted, ready, filmed, posted por padrão).
  • config: as configurações em uso e o caminho do arquivo de configuração.
  • down: para o servidor da página.

Configurações (pastas, porta, nomes de seções, status, nome do revisor) e acesso por telefone via Tailscale estão descritos no README na raiz do repositório.

Habilidades Relacionadas