jameellzx/katib

Katib — habilidade de redação para sites

Adaptado do "AI Market Research Sprint" (escrito para um chat do ChatGPT) em um fluxo de trabalho de agente. Regra central para cada etapa: argumento primeiro, palavras depois — leia references/argument-first.md antes da Etapa 1.

Ordem fixa (nunca pule, nunca reordene)

0 Entrada → 1 Revisão de referência → 2 Pesquisa → 3 Avatar → 4 Resumo da oferta → 5 Crenças → 6 Texto do site → 7 Verificação final

Caminhos

• Arquivos da habilidade: relativos ao diretório base desta habilidade (mostrado quando a habilidade carrega). A ferramenta Reddit é tools/reddit_fetch.py lá — forneça aos pesquisadores seu caminho absoluto.
• Pasta do cliente: <raiz do projeto atual>/katib-clients/<slug-do-cliente>/ com: 00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md

Cada etapa lê os arquivos anteriores. Se a pasta já existir, leia-a e retome do primeiro arquivo ausente (ou refaça apenas a etapa que o usuário nomear).

Etapas

Configuração (primeira execução, e sempre que falhar) — verifique PinchTab: pinchtab --version e pinchtab health. Ausente ou não conectado → guie o usuário por references/setup-pinchtab.md passo a passo antes da pesquisa. Já funcionando → não diga nada, continue.

0. Entrada — Pergunte o que estiver faltando, em uma única mensagem: produto (o que é, preço se conhecido), público, mercado/país, idioma de saída (Árabe do Golfo / Árabe MSA / Inglês / ambos), captura de tela da página de referência (ou URL), qualquer coisa que a marca já tenha (avaliações, prova, garantia, história). Escreva 00-input.md.

1. Revisão de referência — siga references/sales-page-review.md. Escreva 01-reference-review.md. ⏸ Portão: mostre veredito + mapa de seções + o que pegar emprestado. Aguarde OK.

2. Pesquisa — siga references/research-method.md e references/research-agents.md. Lance os 5 pesquisadores em paralelo (R1–R4 + R5 Reddit), mescle em templates/research-doc.md → 02-research.md. Instagram, TikTok e Reddit conectado são lidos através do perfil research do PinchTab (somente leitura); fallback: o Chrome conectado do usuário (própria aba), depois Scrapling. Se o mercado local for escasso, R1 e R5 ampliam para o mesmo tipo de negócio mundialmente e marcam essas citações com o país. Em seguida, escreva 02-research-summary.md para o usuário: no idioma do usuário, seções curtas com cabeçalhos de emoji (quem / sonhos / dor / culpa / crenças / melhor história / concorrentes / candidatos a mecanismo / avisos / lacunas), 1–3 citações-chave cada com [S#]. ⏸ Portão: mostre o bloco de resumo e seções finas. Aguarde OK (o usuário pode pedir mais aprofundamento).

3. Avatar — preencha templates/avatar.md a partir de 02-research.md apenas → 03-avatar.md. Comprador empresarial → "Receita mensal"; consumidor → "Renda / poder de gasto". Sem portão; mostre com a Etapa 4. Mais de um segmento → um arquivo de avatar por segmento (03-avatar-<segmento>.md); o usuário diz qual lidera o texto.

Opções de posicionamento (opcional, quando o usuário perguntar) — execute a habilidade creator-toolkit:personal-brand-expert na marca (funciona também para negócios), usando 02-research.md e os avatares. Escreva 03b-positioning.md com várias opções; a escolha do usuário alimenta a grande ideia na Etapa 4.

4. Resumo da oferta — siga references/offer-brief-guide.md, preencha templates/offer-brief.md na ordem → 04-offer-brief.md. ⏸ Portão após o campo 6: 3 opções para UMP, UMS, grande ideia. Usuário escolhe. Em seguida, termine os campos 7–20.

5. Crenças — siga references/beliefs.md → 05-beliefs.md. ⏸ Portão: usuário aprova as crenças antes de qualquer texto.

6. Texto do site — siga references/website-copy.md, preencha templates/website-copy.md → 06-website-copy.md.

7. Verificação final — execute a Passagem 4 de references/website-copy.md, em seguida mostre o texto, a lista "precisa de prova da marca" e perguntas em aberto. ⏸ Usuário aprova ou pede alterações.

Regras rígidas

• Nunca invente citações, avaliações, números, estudos, pessoas, preços ou garantias. Ausente → pergunte ou sinalize.
• Cada citação de pesquisa é literal com uma URL que foi aberta. Citações do avatar citam [S#] do documento de pesquisa.
• Nunca copie frases da página de referência; pegue emprestado apenas a estrutura.
• Escreva o texto no idioma que o usuário solicitou. Palavras simples, frases curtas.
• Sinalize alegações de saúde, finanças e jurídicas para conformidade.
• Fale com o usuário no idioma dele (geralmente Árabe do Golfo), curto e simples. Os arquivos da habilidade permanecem em inglês.

Posteriormente: anúncios

Ainda não construído. Quando perguntado, reutilize 04-offer-brief.md e 05-beliefs.md (uma crença ou a grande ideia por anúncio). Sem nova pesquisa.