kilaslab/kilas-content

Conteúdo: planejar e criar

Planeje o conteúdo de uma marca e produza-o de ponta a ponta: uma história pesquisada, um gancho que merece atenção, um texto sem traços de IA, uma construção no design da marca e uma ficha de publicação por canal. Tudo que é específico da marca vive em um pacote de marca; o método aqui funciona para qualquer marca. Os quadros são construídos no Figma ou escritos como HTML e renderizados para PNG, dependendo do que a marca escolheu na configuração.

As palavras decidem se alguém para. A maior parte do esforço vai para a pesquisa e a redação, antes do Figma ou de uma câmera. Leia references/writing-craft.md e os dois exemplos trabalhados antes de escrever qualquer coisa: references/examples/linux-7.4-carousel.md (um registro de notícia) e references/examples/ai-cost-js-carousel.md (um experimento de outra pessoa). Cada um lista os rascunhos que perderam e por quê; imite os movimentos, não as frases.

Comece aqui, a cada execução

Os caminhos para scripts/, references/, templates/ e brands/ estão dentro da pasta desta skill; content/ está no projeto em que você trabalha. Execute comandos a partir da raiz do projeto com o caminho da skill, por exemplo python3 <skill>/scripts/new_item.py content ... (<skill> é a pasta onde este arquivo está). Scripts que usam Pillow (contact_sheet.py, slides_to_pdf.py, artefact_marks.py, ref_sheets.py) executam sem python3 -I.

0. Verificação de configuração. Leia content/setup.md no projeto. Se não existir, esta é a primeira execução: execute a skill setup-content (instalada junto; neste repositório em ../setup-content/SKILL.md; invoque-a, ou siga-a manualmente) antes de qualquer outra coisa. Ela pergunta qual marca, coleta os ativos da própria marca do seu site e perfis com permissão, escolhe o renderizador (Figma ou HTML → PNG) e escreve o pacote de marca.
1. Encontre o pacote de marca (brands/README.md): content/brand/ no projeto, senão brands/<nome>/ nesta skill. Leia brand.md, design.md e content/brand/assets/README.md se existir (as próprias fotos e logotipos da marca vêm antes de banco de imagens). Qualquer coisa marcada como (proposto) não está definida; pergunte antes que um plano dependa dela.
2. Levante as ferramentas e use todas que ajudarem (references/research-tools.md): pesquisa na web, busca de página, um navegador real (ego-browser), MCPs de redes sociais ou acesso X integrado, MCP do Figma e geração de imagem: sua própria ferramenta de imagem se tiver uma (Grok Imagine do Grok Bot, Codex, ChatGPT, Antigravity), depois python3 <skill>/scripts/gen_image.py detect (agy, OpenAI, Gemini, chaves xAI). Anote o que está faltando.
3. Encontre o workspace (templates/workspace.md): content/ com plan/, items/, reviews/, ideas.md, design-log.md. Crie-o na primeira vez.
4. Escolha o modo abaixo.

O usuário quer	Modo
um plano, um calendário, "rencana konten bulan ini"	Planejar
uma peça: carrossel, post único, thread, script de Reels, post no LinkedIn, artigo	Criar
várias peças de uma fonte	Reaproveitar
saber o que funcionou e o que mudar	Revisar
configurar uma nova marca, mudar o renderizador ou atualizar ativos	Configurar (a skill setup-content)

Planejar

1. Leia as entradas (references/planning.md seção 1): pacote de marca, última revisão, ideas.md, os momentos do mês (verifique datas), capacidade, objetivo do proprietário.
2. Escreva content/plan/AAAA-MM.md a partir de templates/plan-month.md: pilares com suas participações, séries em sua cadência, cerca de um quarto dos slots reativos, cada item forte dividido em 3–5 formatos em dias diferentes.
3. python3 <skill>/scripts/check_plan.py content/plan/AAAA-MM.md --brand <pacote>/brand.md até não haver FALHA; explique qualquer aviso que você mantiver nas notas do plano.
4. Relate: o mês em três linhas, o que é proposto e precisa de um sim, as lacunas.

Criar

1. Pasta do item: python3 <skill>/scripts/new_item.py content <data> <slug> <formato>.
2. Pesquisa (research-tools.md): fonte primária, um link de profundidade, correções desde a publicação, palavras próprias de pessoas nomeadas, o ângulo local, uma segunda fonte por número.
3. História em brief.md (writing-craft.md seções 1–4): cinco perguntas, a virada, a escada (berita, uji coba, daftar referência, ou uma rubrica de copy-playbook.md), o slide ou post que vale a pena salvar, cinco ganchos em pelo menos três formas passados pelos portões e pelos duelos, uma família de metáforas com sua linha Verbos:.
4. Texto em copy.md para o formato (references/formats/: carousel.md, single-post.md, x.md, threads.md, linkedin.md, reels-tiktok.md, long-form.md), uma nota de fonte > sob cada número, nome e citação. Cada manchete passa por "lalu kenapa?" e a metáfora está em pelo menos três delas; ressalvas vão onde writing-craft.md 7b as coloca; a ação passa por "quem, com o quê, quando". Então python3 <skill>/scripts/lint_copy.py <item>/copy.md --format <formato> --brand <pacote>/brand.md deve sair com código 0 (new_item.py imprime o --format correto: thread passa como x, document como linkedin). Leia seus avisos e sua leitura só de manchetes; escreva essa leitura em brief.md, e leia o texto em voz alta uma vez.
5. Imagens (image-sourcing.md): artefatos reais em quadros de evidência; para quadros de metáfora, as próprias fotos da marca, depois uma imagem gerada automaticamente quando nada se encaixa (sua própria ferramenta de imagem primeiro, depois agy, depois uma API paga apenas se content/setup.md permitir), depois Unsplash; um fio visual, créditos mantidos do manifesto. O proprietário pode trocar a ferramenta de imagem ou parar de gerar a qualquer momento.
6. Escolha o esquema e os layouts (design-variety.md): o esquema de cores da série, ou para uma peça avulsa um que as peças anteriores não usaram; depois uma variante por slide de acordo com o trabalho do slide e com o que content/design-log.md diz que foi usado recentemente, para que duas peças nunca se pareçam. Escreva-os na tabela "Design" de brief.md, com um estilo de manchete e um slide que quebra o padrão. As páginas de galeria do pacote de marca (Figma) ou content/setup-gallery/*.jpg (HTML), e refs/ quando o pacote as tem, mostram as opções.
7. Construa com o renderizador em content/setup.md (design-system.md); quando ele disser ambos, siga sua regra para quais peças vão para onde, senão pergunte:
   • Figma (figma-mechanics.md): as funções de layout em scripts/figma-helpers.js, agrupadas com o bloco BRAND do pacote por scripts/figma_bundle.py --brand <pacote>/design.md --page "<nome>" --scheme <esquema> --n <quadros> (a ferramenta aceita 50.000 caracteres), em uma nova página do arquivo Figma da marca; nunca toque em outras páginas. Faça upload das imagens, depois ajuste os tons em uma segunda chamada com os pares do esquema (duotone(id, 'light' | 'dark')).
   • HTML → PNG (html-render.md): scripts/new_html.py configura a pasta html/ do item com o kit e o CSS da marca; escreva slides.html com os layouts do kit, com as fotos escolhidas e imagens geradas copiadas para html/img/; scripts/render_slides.py renderiza um PNG por slide. Reels: storyboard.md + um quadro de capa 1080×1920 (Figma, ou uma página HTML separada como diz a seção 4 de html-render.md).
8. Verifique de forma barata: primeiro a verificação de layout (layoutCheck() no Figma, os problemas que render_slides.py imprime no HTML) e corrija o que for relatado; depois olhe a capa, o quadro de dados e o que mudou (capturas de tela uma de cada vez no Figma; os PNGs no HTML). Se o usuário parar as capturas de tela, pare e diga quais quadros ficaram sem verificação.
9. Ficha de publicação: publish.md com o texto por canal, hashtags dentro dos limites, texto alternativo, horário, links, créditos; adicione uma linha a content/design-log.md. A publicação é etapa do proprietário a menos que ele peça explicitamente para você postar uma peça específica através de uma ferramenta conectada; confirme primeiro.
10. Relate: onde está, a direção em duas linhas, os layouts escolhidos, o que foi e não foi verificado, quais ferramentas de pesquisa você tinha e quais faltavam, e a legenda.

Reaproveitar

Planeje os cortes juntos (planning.md seção 6), uma pasta de item, uma linha por corte no plano. Cada corte é reescrito para seu formato (references/formats/), diz algo completo por si só e linka de volta. Os quadros do carrossel funcionam como o documento do LinkedIn (scripts/slides_to_pdf.py) e a postagem de fotos do Threads/TikTok.

Revisar

Escreva content/reviews/AAAA-MM.md a partir de templates/review-month.md: números apenas da plataforma ou do proprietário, datados; compare cada peça com a mediana da própria marca para seu formato; decida manter, corrigir ou parar por série; leve as decisões para o plano do próximo mês. Sem números compartilhados: liste o que coletar e pare.

Regras de escrita que mais pesam

Método completo em writing-craft.md, regras em copy-playbook.md, idioma em language/<idioma>.md.

• Gancho = número exato + cena + apostas, ou uma das seis formas na seção 3b de writing-craft.md. Escreva cinco em três formas, passe pelos portões (≤30 palavras, simples, sem ressalva, honesto, a resposta retida, tensão), duelo os sobreviventes e escreva por que cada perdedor perdeu. Não pontue: auto-pontuações empatam.
• Manchetes são afirmações com uma consequência: cada uma passa por "lalu kenapa?". Palavras do tópico vão na sobrancelha. Marque a(s) uma ou duas palavras que carregam a afirmação.
• Uma família de metáforas, dita uma vez, depois carregada nos verbos de pelo menos três manchetes.
• Uma virada no final da história; um quadro ou post que vale a pena salvar.
• Traga para casa: o próprio preço, data, lugar, empresa ou ação do público.
• Números comparam de forma justa, gráficos começam em zero, hedges são copiados da fonte, primeira pessoa apenas para o que a marca fez.
• Hedges ficam na frase; ressalvas têm um orçamento: nenhuma na capa ou em uma manchete, uma no slide de dados, uma no slide de opinião, o resto na legenda.
• Opinião é rotulada e termina em uma ação que passa por "quem, com o quê, quando".
• Um CTA do pacote de marca; a promessa descreve o que a peça acabou de fazer.
• Idioma do pacote de marca; outro idioma apenas quando o usuário pedir explicitamente para aquela peça.
• Sem aberturas genéricas, sem traços de IA; o lint pega a maioria.

Portão de qualidade

• Pacote de marca lido; nada (proposto) usado como definido sem perguntar.
• Toda ferramenta de pesquisa disponível foi usada onde ajuda; lacunas relatadas.
• Cinco perguntas da história respondidas com o ângulo local; a virada posicionada.
• Workshop de ganchos feito com portões e duelos; a capa tem ≤30 palavras sem ressalva e funciona sozinha.
• Leitura só de manchetes escrita em brief.md e conta a história; a metáfora está em pelo menos três manchetes; uma peça que vale a pena salvar, nomeada.
• A ação passa por "quem, com o quê, quando".
• lint_copy.py sai com 0 para o formato; todo número, nome e citação tem uma nota.
• Limites da plataforma respeitados (formats/specs.md): hashtags, caracteres, zonas seguras.
• Layouts escolhidos por slide em brief.md; capa e marca de manchete diferem da peça anterior em content/design-log.md; um slide quebra o padrão.
• Um esquema aplicado; as próprias fotos da marca usadas onde se encaixam; fotos com tom corrigido; capturas de tela em cores, inalteradas, creditadas, marcadas com marcas de realce.
• Verificação de layout limpa (layoutCheck() no Figma, render_slides.py no HTML) ou cada nota explicada; capa e quadro de dados vistos (ou a lacuna relatada).
• Fechamento: um CTA, todas as fontes e créditos; imagens geradas rotuladas como ilustrações.
• publish.md completo e uma linha adicionada a content/design-log.md; nada postado, curtido ou seguido sem consentimento explícito.
• Planos passam em check_plan.py.

Mapa de arquivos

Arquivo	Leia quando
brands/README.md, brands/<marca>/brand.md, design.md	toda execução
../setup-content/SKILL.md, references/brand-onboarding.md	primeira execução (sem content/setup.md), uma nova marca, um novo renderizador
references/planning.md	planejando, reaproveitando, revisando
references/writing-craft.md, references/examples/*.md (dois carrosséis trabalhados com rascunhos rejeitados)	antes de escrever qualquer coisa
references/copy-playbook.md	frameworks, formato copy.md, CTA, legenda
references/language/id.md, en.md	o idioma da marca
references/formats/*.md	o formato que está sendo feito; specs.md para limites
references/design-system.md, design-variety.md, design-references.md	antes de construir quadros: funções, variantes de layout e como escolhê-las, padrões de outras contas
references/figma-mechanics.md	antes do primeiro use_figma; upload, duotone, capturas de tela
references/html-render.md, templates/html/	o renderizador HTML → PNG: configuração, referência de classe, renderizar, verificar
references/image-sourcing.md, research-tools.md	pesquisa e imagens
references/patterns-from-data.md	por que as regras são o que são
references/prerequisites.md	instalando complementos e ferramentas opcionais
templates/	workspace, configuração, plano, brief, publicação, revisão, ideias, log de design; html/ (kit de slides e exemplo)
scripts/	lint_copy.py, check_plan.py, new_item.py, figma-helpers.js (layouts, esquemas), figma_bundle.py, figma-gallery.js + figma-gallery-2.js, figma-gallery-schemes.js, brand_css.py, new_html.py, render_slides.py, crawl_site.py, capture_profile.sh, artefact_marks.py, ref_sheets.py, slides_to_pdf.py, capture_artefact.sh, x_post.py, scan_site_tokens.sh, unsplash_search.py, gen_image.py, agy_image.sh, contact_sheet.py, export_oss.sh

Quando não usar isso

Não é para uma apresentação de slides (use uma skill de slides), não para construir um site e não para um ajuste de uma palavra em um post existente (edite diretamente).