Communitygithub.com

minkhant1996/soemind-forge

Escreva as palavras — ganchos que param a rolagem, scripts orientados por frameworks e legendas prontas para plataforma com hashtags. Use quando o usuário precisar de ideias de ganchos, um roteiro de vídeo/anúncio, cópia de anúncio, legendas de postagens, ou disser "o que devo postar", "escreva um roteiro", "me dê ganchos", "escreva a legenda".

O que é soemind-forge?

Este skill é uma ferramenta completa de copywriting para criadores de conteúdo e profissionais de marketing, projetada para eliminar o bloqueio criativo ao gerar ganchos, roteiros e legendas com base em frameworks comprovados de resposta direta. Ele suporta plataformas como TikTok, Instagram, YouTube e Facebook, e se integra perfeitamente ao ecossistema de skills do Claude Code, Cursor e Codex. O fluxo de trabalho começa com a geração de uma variedade de ganchos organizados por ângulos (problema, curiosidade, resultado, etc.), permite que o usuário escolha um e, em seguida, constrói um roteiro completo usando frameworks como PAS, AIDA ou BAB, com indicações de voz e visuais estimados. Por fim, gera legendas prontas para publicação com hashtags, adaptadas a cada plataforma. Uma característica fundamental é a verificação de referências de estilo salvas (como exemplos de postagens anteriores) para garantir consistência de tom e voz, além de evitar violações de restrições definidas no projeto. O skill opera via comandos CLI, como `node workflows/cli.cjs generateHooks '<json-args>'`, e não requer a criação de novos arquivos de script, apenas a chamada direta dos comandos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/minkhant1996/soemind-forge/tree/HEAD/skills/write-copy

Perguntar na sua IA favorita

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

Documentação

Escreva Cópia (ganchos · roteiro · legenda)

O gargalo criativo não é gerar mídia — é saber o que dizer. Este skill gera ganchos, roteiros e legendas usando frameworks comprovados de resposta direta e, em seguida, permite que o usuário escolha e refine. Comandos de fluxo de trabalho — chame a CLI, não escreva um script:

node workflows/cli.cjs generateHooks '<json-args>'     # também: generateScript, generateCaption

As assinaturas de chamada TypeScript mostradas abaixo documentam os argumentos de cada comando — traduza-os em node workflows/cli.cjs <comando> '<json-args>', não os cole em um novo arquivo.

Primeiro, extraia o contexto do projeto quando ele existir (project.md público/pontos de dor/oferta; brand.md tom/restrições) para que a cópia esteja alinhada à marca e nunca viole restrictions.


PASSO 0: Verifique a cópia de referência ANTES de escrever qualquer coisa

Consistência de voz vem de exemplos, não de adjetivos. Antes de gerar ganchos, roteiros ou legendas:

  1. Verifique o registro em busca de exemplos de cópia salvos:
    node workflows/cli.cjs resolveAsset '["{nome}","style-copy"]'   # um id style_references contendo exemplos de cópia
    cat projects/{nome}/assets/style/copy-examples.md 2>/dev/null
    cat projects/{nome}/style-samples/caption-examples/*.md 2>/dev/null   # caixa de entrada do usuário
    
    Encontrou → extraia os padrões (comprimento da frase, uso de emoji, estilo de hashtag, fraseologia de CTA, formalidade) e ESPELHE-OS em tudo que você escrever abaixo.
  2. Nada salvo → pergunte uma vez:

    "Você tem postagens, legendas ou roteiros anteriores que funcionaram bem — ou contas cujo estilo de cópia você gosta? Cole 1-3 exemplos (ou 'nenhum' — irei pelo brand.md)."

    • Exemplos fornecidos → salve em projects/{nome}/assets/style/copy-examples.md e registre (registerAsset '["{nome}","style_references",...]') para que peças futuras os reutilizem.
    • "nenhum" → prossiga a partir do tom de brand.md e indique quais suposições de tom você fez.
  3. Quando existirem exemplos, anote em prompts.txt a qual referência a cópia foi associada.

PASSO 1: Ganchos (escolha o ângulo antes de escrever tudo)

Gere uma variedade de ganchos em diferentes ângulos e deixe o usuário escolher 1–2 para desenvolver.

node workflows/cli.cjs generateHooks '{"topico":"app de planejamento de estudos com IA","publico":"universitários se preparando para provas finais","pontoDeDor":"não sabem por onde começar a revisar","plataforma":"tiktok","quantidade":8}'
# h.data.hooks: [{ texto, angulo }]  — ângulos: problema | curiosidade | resultado | contrário | pergunta | estatística | história

Mostre-os agrupados por ângulo e pergunte qual usar. Não escolha automaticamente — o gancho decide toda a peça.


PASSO 2: Roteiro (orientado por framework, dimensionado para duração)

Uma vez escolhido o gancho, escreva o roteiro com um framework que se adapte ao objetivo:

FrameworkMelhor para
hook-reter-recompensavídeo curto (TikTok/Reels/Shorts) — padrão
PAS (Problema-Agitação-Solução)anúncios orientados por dor
AIDA (Atenção-Interesse-Desejo-Ação)resposta direta clássica
BAB (Antes-Depois-Ponte)transformação / resultados
história-personagem-soluçãodepoimentos / história do fundador
# gancho: passe o texto do gancho escolhido do generateHooks
node workflows/cli.cjs generateScript '{"brief":"app de planejamento de estudos com IA que cria um cronograma de revisão em 60 segundos","framework":"PAS","plataforma":"tiktok","duracaoSegundos":30,"gancho":"<texto do gancho escolhido>","cta":"Teste grátis — link na bio"}'
# s.data: { framework, secoes:[{rotulo, voz, visual}], contagemPalavras, duracaoEstimadaSegundos }

Mostre o roteiro como seções rotuladas (indicação de voz + dica visual) e a duração estimada. Sinalize se duracaoEstimadaSegundos estiver longe do alvo para que o usuário possa cortar/expandir. Este texto de voz alimenta diretamente generateVoiceover() e as dicas visuais por cena visual alimentam generateStoryboard() / o skill de vídeo.


PASSO 3: Legenda (pronta para publicação, por plataforma)

A milha final — a cópia da postagem + hashtags que realmente acompanham o vídeo/imagem.

node workflows/cli.cjs generateCaption '{"topico":"app de planejamento de estudos com IA","plataforma":"instagram","tom":"amigável, confiante","cta":"Link na bio","quantidade":3}'   # plataforma: tiktok | instagram | youtube | facebook
# c.data.captions: [{ texto, hashtags:[] }]

Gere variantes por plataforma se a peça for postada em várias (cada plataforma tem normas diferentes de comprimento e hashtag). Salve a legenda escolhida junto à saída, por exemplo, projects/{nome}/output-contents/.../caption.md.


Como se conecta

generateHooks → escolher → generateScript → { voz → generateVoiceover,
                                              dicas visuais → generateStoryboard → video }
                                           → generateCaption → caption.md

Sempre sugira e confirme — apresente opções, recomende uma com um motivo, deixe o usuário editar. Nunca invente estatísticas/depoimentos (puxe apenas os reais de project.md).

Habilidades Relacionadas