Communitygithub.com

77777R7/screenstudio-demo-optimizer

Skill do Codex e scripts auxiliares para otimizar com segurança gravações de demonstração do Screen Studio.

O que é screenstudio-demo-optimizer?

Este skill capacita agentes de IA (como Codex ou Cursor) a transformar a intenção de edição de um usuário em edições seguras e reversíveis na linha do tempo do Screen Studio. Ele é ideal para desenvolvedores que criam demonstrações e precisam de um fluxo de trabalho automatizado, padronizado e não destrutivo. O skill oferece scripts para criar cópias de edição, analisar a linha do tempo, gerar planos de compressão baseados em durações-alvo e aplicar alterações de velocidade e zoom. Suporta vários estilos pré-definidos (social-demo, tutorial, investor-demo) e prioriza a segurança: por padrão, opera sempre em uma cópia do projeto original e exige confirmação antes de qualquer mutação. Ele funciona analisando o arquivo `.screenstudio` (que contém a linha do tempo, fatias, velocidades e zooms) e aplicando heurísticas de compressão e conforto de zoom definidas nos arquivos de referência. Este skill foi projetado para ser usado com o Claude Code ou Codex, mas os scripts também podem ser usados manualmente no terminal.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add 77777R7/screenstudio-demo-optimizer

Perguntar na sua IA favorita

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

Documentação

Otimizador de Demonstrações do Screen Studio

Use este skill para transformar a intenção de edição de um usuário em edições seguras e reversíveis na linha do tempo do Screen Studio.

O skill não é um estilo de edição fixo. Deixe sempre o resultado desejado pelo usuário controlar o plano: duração alvo, ritmo, preservação da lógica, limites de velocidade, comportamento de zoom e formato de saída.

Fluxo de Trabalho Principal

  1. Esclareça ou infira o contrato de edição:
    • Duração alvo: exata, aproximada ou sem restrição.
    • Estilo: demonstração social, tutorial, demonstração para investidores, passo a passo interno, revisão calma, teaser rápido ou personalizado.
    • Prioridade: preservar cada etapa lógica, permitir cortar esperas, permitir excluir repetições, preservar áudio, preservar zooms, reduzir movimento.
    • Saída: apenas plano, cópia editada ou exportação.
  2. Prepare uma cópia segura antes de modificar qualquer coisa.
    • Use scripts/prepare_edit_copy.mjs.
    • Nunca modifique o projeto .screenstudio original, a menos que o usuário peça explicitamente.
  3. Analise o projeto.
    • Use scripts/analyze_timeline.mjs.
    • Leia fatias, velocidades, intervalos de reprodução, intervalos de zoom e riscos de zoom de sub-segundo.
  4. Crie um plano editável.
    • Use scripts/plan_compression.mjs quando uma duração alvo for fornecida.
    • Explique o plano em termos humanos antes de aplicá-lo.
  5. Peça confirmação antes de modificar a cópia de edição.
  6. Aplique as alterações confirmadas.
    • Use scripts/apply_speed_plan.mjs.
    • Use scripts/normalize_project_json.mjs após salvamentos externos ou via CLI.
  7. Revise o conforto do zoom.
    • Use scripts/optimize_zoom_track.mjs --review.
    • Aplique alterações de zoom somente após confirmação.
  8. Verifique.
    • Use scripts/verify_project.mjs.
    • Se o Screen Studio estiver disponível, use opcionalmente scripts/screenstudio_cdp_open_project.mjs e screenstudio --port <port> status.

Contrato de Preferências

Se o usuário der intenção suficiente, prossiga com valores padrão razoáveis. Se o alvo for ambíguo, faça uma pergunta concisa.

Contrato padrão quando o usuário apenas disser "melhore isso":

{
  "targetSeconds": null,
  "style": "balanced-demo",
  "preserveLogic": true,
  "allowDelete": false,
  "maxReadingSpeed": 1.6,
  "maxActionSpeed": 3,
  "maxWaitSpeed": 10,
  "zoomPolicy": "reduce-jumpy-zooms"
}

Predefinições comuns:

  • social-demo: curto, nítido, alta velocidade de espera, reduzir zooms bruscos.
  • tutorial: mais lento, preservar etapas, evitar alterações agressivas de zoom.
  • investor-demo: conciso, preservar momentos narrativos, enfatizar resultados.
  • agent-workflow: acelerar fortemente esperas/carregamentos, preservar decisões principais e resultado final.
  • review-only: analisar e recomendar, não modificar.

Leia references/compression-rules.md para heurísticas de ritmo e references/zoom-comfort-rules.md antes de editar zooms.

Guia Rápido de Scripts

Prepare arquivos seguros:

node scripts/prepare_edit_copy.mjs "/caminho/para/demo.screenstudio"

Analise:

node scripts/analyze_timeline.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"

Planeje um corte de 90 segundos:

node scripts/plan_compression.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" --target-seconds 90 --preset social-demo > /tmp/plan.json

Aplique um plano confirmado:

node scripts/apply_speed_plan.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" /tmp/plan.json
node scripts/verify_project.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"

Revise o conforto do zoom:

node scripts/optimize_zoom_track.mjs "/caminho/para/demo.agent-edit-copy.screenstudio" --review

Abra no modo CDP do Screen Studio quando o Screen Studio estiver instalado:

node scripts/screenstudio_cdp_open_project.mjs "/caminho/para/demo.agent-edit-copy.screenstudio"

Regras de Segurança

  • Por padrão, opte por plano-primeiro para edições não triviais.
  • Não sobrescreva o projeto original por padrão.
  • Não exclua fatias a menos que o usuário tenha permitido a exclusão.
  • Trate gravações com muito áudio ou narração como sensíveis à velocidade.
  • Normalize project.json após salvamentos, porque alguns fluxos do Screen Studio/CLI podem envolver dados do projeto como strings JSON aninhadas.
  • Verifique a duração final a partir do arquivo do projeto e, quando possível, do tempo de execução do Screen Studio.
  • Relate exatamente as fatias e zooms alterados.

Leia references/safety-and-backups.md antes de realizar ações destrutivas ou irreversíveis.

Limitações Conhecidas

  • Os componentes internos do Screen Studio podem mudar entre versões. Se a abertura via CDP falhar, volte para a análise do arquivo do projeto e informe o usuário.
  • A qualidade visual não pode ser totalmente avaliada apenas com dados da linha do tempo. Use extração de quadros ou a visualização do Screen Studio quando disponível.
  • Os scripts incluídos são primitivos conservadores. O agente ainda deve explicar as compensações subjetivas e pedir confirmação.

Habilidades Relacionadas