DrErwin/videoscript-skill

Transcrições VideoScript

O que esta skill faz

Ela gerencia o cliente de linha de comando videoscript. A CLI se comunica com a API pública do VideoScript usando uma chave que o próprio usuário emitiu; o serviço realiza a extração, transcrição e faturamento. Esta skill nunca faz requisições HTTP diretamente e nunca manipula uma chave.

Antes de qualquer coisa

videoscript auth status --json

• {"authenticated": true, ...} → prossiga.
• Código de saída 3 → o usuário não está autenticado. Peça para ele criar uma chave de API no site do VideoScript e executar videoscript auth login --token <chave> ele mesmo. Nunca peça para ele colar a chave na conversa, e nunca a repita.
• videoscript não encontrado → peça ao usuário para instalá-lo (npm install -g videoscript).

O fluxo normal

# 1. enviar (retorna um id de tarefa imediatamente)
videoscript transcribe create "<url>" --json

# 2. aguardar (respeita o Retry-After do servidor)
videoscript transcribe wait <id> --json

# 3. salvar a transcrição em um arquivo, não na conversa
videoscript transcript get <id> --format markdown --output notes/<nome>.md

Regras importantes:

• Um envio = uma chave de idempotência. A CLI gera e exibe essa chave em --json; se uma chamada precisar ser repetida, reutilize essa chave (--idempotency-key) para que o usuário nunca seja cobrado duas vezes.
• Transcrições longas vão para arquivos. Leia o arquivo apenas até onde a solicitação do usuário precisar. Nunca cole uma transcrição de uma hora inteira na conversa.
• O consumo é visível. Cada tarefa concluída gasta Créditos do usuário e aparece na biblioteca dele; informe isso antes de enviar algo longo.
• Os limites de conteúdo são do serviço, não seus para contornar. Logins, conteúdo pago, DRM, bloqueios regionais e transmissões ao vivo são recusados por design. Não sugira proxies, cookies ou baixadores de terceiros.

Quando algo dá errado

Códigos de saída: 3 autenticação, 4 tarefa inexistente, 5 tentar novamente, 6 Créditos/orçamento, 7 fonte recusada.

• 5 → aguarde o Retry-After que a CLI informa e tente novamente. A CLI já tenta duas vezes por conta própria.
• 6 → informe ao usuário que o saldo ou o orçamento desta chave está esgotado; nunca tente uma compra.
• 7 → explique a restrição claramente e pare. Não tente novamente.
• 1/2 → erro inesperado ou argumentos incorretos; leia a mensagem e corrija a chamada.

Tabelas completas: reference/cli.md e reference/errors.md.

O que esta skill não faz

Uploads, trabalhos em lote, exclusão de tarefas, pagamentos, ações administrativas ou qualquer coisa que precise da senha do usuário. Os escopos da chave são aplicados pelo serviço.