rajat974/yellowworkshops-skill

yellowworkshops

O criador comprou o YellowWorkshops e adicionou este plugin. Esta skill prepara o próprio computador deles na primeira vez (cerca de 10 minutos, uma vez), mantém-no atualizado, abre o guia e então entrega cada edição para a skill do editor completo (ugc-reels-editor). Os criadores não são técnicos: nunca peça para eles digitarem comandos; execute tudo você mesmo e fale em palavras simples.

Executar no próprio computador deles

Tudo é executado no próprio PC Windows ou Mac do criador através da aba Code do aplicativo de desktop Claude (ou Claude Code). Se a verificação de status disser SANDBOX, você está em um sandbox pequeno na nuvem, não no computador deles: diga a eles, em uma ou duas linhas, para abrir o aplicativo de desktop Claude, escolher Code, selecionar uma pasta no computador deles e perguntar novamente lá. Nunca copie o material deles para contornar isso.

Os comandos de configuração

Os scripts estão na pasta scripts ao lado deste arquivo (o diretório base desta skill). Use o script adequado para o computador:

• Windows (PowerShell): powershell -NoProfile -ExecutionPolicy Bypass -File "<skill dir>\scripts\start.ps1" <comando>
• Mac (bash): bash "<skill dir>/scripts/start.sh" <comando>

Comandos: status · all --key YWS-XXXX-XXXX-XXXX · update --daily · diag. A primeira execução baixa uma cópia privada do Python (com checksum verificado) para ~/yellowworkshops/runner; nada é instalado globalmente no sistema e nenhuma senha de administrador é necessária.

Toda vez que o criador pedir um reel (ou qualquer coisa relacionada ao YellowWorkshops)

1. Execute status. Ele imprime JSON e depois um dos seguintes: READY, NOT_SET_UP ou SANDBOX: ….
2. NOT_SET_UP: configure (abaixo), depois continue com o pedido.
3. READY: execute update --daily (rápido; no máximo uma verificação real por dia). Se imprimir UPDATED to …, diga a eles em uma linha o que há de novo (o texto após os dois pontos). Em seguida, entregue ao editor: use a skill ugc-reels-editor se ela estiver listada; caso contrário, leia ~/.claude/skills/ugc-reels-editor/SKILL.md e siga-a. Execute os scripts do editor com o Python em ~/yellowworkshops/ugc-reels-home.json (python_cmd) — o mecanismo só funciona com esse Python. Novos projetos vão para ~/yellowworkshops/projects/<nome do reel>/.

Configuração inicial

1. Você precisa da chave de licença deles (YWS-XXXX-XXXX-XXXX, no e-mail de compra). Se eles não a forneceram, peça — a única pergunta que você faz. Diga a eles em uma linha: "Configurando seu computador agora: cerca de 10 minutos, uma vez. Seus vídeos nunca saem deste computador."
2. Execute all --key <CHAVE>. Ele baixa cerca de 1 GB, então execute em segundo plano e aguarde a conclusão (não faça polling em loop). Ele imprime uma lista numerada de etapas ([3/7] Ativando sua licença…) com porcentagens de download; repasse os títulos das etapas brevemente, não todas as linhas. Se um comando for interrompido por limite de tempo, execute o mesmo comando novamente: as etapas concluídas são ignoradas e os downloads são retomados.
3. Leia o resultado pela última linha e código de saída:
   • READY: … (código 0) → diga a eles que está configurado, mencione "digite 'guia' a qualquer momento para ideias", depois continue com o pedido (etapa 3 da seção acima). A skill do editor acabou de ser adicionada a ~/.claude/skills/ugc-reels-editor; se ainda não estiver listada nesta sessão, leia o SKILL.md diretamente.
   • NEEDS_KEY (código 11) → peça a chave, execute novamente com --key.
   • SANDBOX: … (código 10) → veja "Executar no próprio computador deles".
   • SETUP_ERROR: <motivo> (código 1) → corrija com o playbook abaixo, depois execute all novamente. Os detalhes estão em ~/yellowworkshops/install-log.txt.

Playbook de correção (SETUP_ERROR)

Corrija o que puder sozinho, explique o restante em uma ou duas frases simples e depois tente novamente.

• Não foi possível acessar / Não foi possível baixar → verifique a internet (curl -I https://yellowworkshops.com). Uma rede corporativa, VPN ou firewall pode bloquear downloads: peça para tentar outra rede (hotspot do celular) e tente novamente.
• Apenas N GB livres → informe quanto liberar e onde (Lixeira, Downloads); você pode mostrar as maiores pastas nos Downloads, mas não apague nada sem a permissão clara deles.
• Chave já usada em outro computador → um computador por licença. Ofereça: no computador antigo, diga "mover minha licença do YellowWorkshops" (executa reels deactivate), ou escreva para [email protected] se esse computador não estiver mais disponível.
• Chave não encontrada / reembolsada → peça para copiar a chave novamente do e-mail (letras O vs 0); caso contrário, suporte.
• Antivírus / não foi possível descompactar / um programa ainda está usando → feche outras sessões do Claude que estão editando um reel e a janela do editor; se um antivírus colocou arquivos em quarentena, peça para permitir a pasta yellowworkshops na pasta pessoal.
• Windows "caminho muito longo" → o caminho da pasta pessoal é muito longo; defina YWS_HOME para um caminho curto como C:\yellowworkshops no comando de configuração e tente novamente.
• FFmpeg/mecanismo não inicia neste Mac → anote a versão do macOS a partir de status; é necessário macOS 12 ou mais recente. Macs antigos não são suportados: diga isso educadamente e encaminhe para [email protected] para reembolso.
• Lista de download não está assinada / auxiliar de configuração muito antigo → atualize este plugin (/plugin update yellowworkshops — execute para eles se puder, caso contrário diga essa linha), depois tente novamente.
• Qualquer outra coisa → execute diag, explique o que vê e ofereça-se para escrever um e-mail de suporte para eles enviarem para [email protected] com a saída do diag (ela não contém material nem nomes).

Guia

Quando o criador digitar guia, "o que posso perguntar?" ou "mostre-me exemplos": abra o Guia do YellowWorkshops, uma página com prompts prontos para copiar. Se ~/yellowworkshops/ugc-reels-home.json tiver guide_url, abra esse artefato. Caso contrário, publique assets/guide.html da skill do editor (~/.claude/skills/ugc-reels-editor/assets/guide.html) uma vez como artefato, salve sua URL como guide_url nesse JSON e abra-o. Ele não contém dados de reel. Se a página ainda não estiver lá, forneça oito bons exemplos de prompts no chat.

Outros pedidos

• Atualizar / obter os novos estilos → update (sem --daily), depois ~/yellowworkshops/bin/reels styles update (Windows: %USERPROFILE%\yellowworkshops\bin\reels.cmd styles update); relate o que mudou e nomeie quaisquer novos estilos (eles aparecem com um selo Novo na Galeria do editor).
• Mover a licença para um novo computador → neste computador execute ~/yellowworkshops/bin/reels deactivate (Windows: %USERPROFILE%\yellowworkshops\bin\reels.cmd deactivate), depois no novo computador adicione o plugin e configure com a mesma chave.
• Algo está quebrado → status, depois diag; corrija com o playbook.

Privacidade (uma promessa ao criador)

O material, áudio, quadros, transcrições e renderizações deles nunca saem do computador. A configuração baixa apenas arquivos de programa públicos de yellowworkshops.com (cada um verificado contra nossa lista assinada); a ativação envia apenas a chave de licença e um ID de computador com hash.