Markusgjesdal/listing-writer

Escritor de listagem

Transforma uma pasta de arquivos de produto em uma listagem de loja que diz claramente o que o comprador recebe. A listagem é construída a partir de fatos encontrados nos arquivos, não de exagero. Saída: listing.md ao lado da pasta do produto.

Quando usar

• Um produto digital (template, guia em PDF, imprimível, pacote de código, pacote de prompt ou skill, planilha) foi construído e precisa de texto para a loja.
• Uma listagem antiga deve ser reescrita do zero. (Para avaliar e corrigir uma listagem existente, use listing-audit se você o tiver.)

Quando não usar

• O produto ainda não foi construído. Escreva a listagem depois que os arquivos existirem, para que cada afirmação possa ser verificada contra eles.

Entradas

• Obrigatório: caminho para a pasta do produto ou arquivo zip.
• Pergunte uma vez se não encontrado nos arquivos: para quem é (uma frase), preço ou faixa de preço, a loja onde será publicado, e qualquer coisa que o comprador já precise ter (software, conta, nível de habilidade).
• Opcional: anotações do próprio usuário, uma listagem antiga, uma lista de capturas de tela, feedback real de clientes que o usuário possa mostrar (use apenas feedback que o usuário confirme ser real e permitido citar).

Passos

1. Faça o inventário do produto. Liste cada arquivo que o comprador receberá (navegue recursivamente em pastas e zips). Conte páginas, folhas, templates, skills ou qualquer que seja a unidade. Anote formatos e qualquer software necessário. Escreva esta lista primeiro: ela é a fonte da verdade para o restante.
2. Encontre o trabalho. Em uma frase, declare a tarefa que o comprador termina mais rápido ou melhor com este produto. Se não conseguir, pergunte ao usuário antes de escrever qualquer outra coisa.
3. Preencha templates/listing-template.md seção por seção:
   • Opções de título (3): com menos de 70 caracteres, começando pelo resultado ou pela coisa, inclua o formato (ex.: "Template Notion", "PDF", "pacote de skills"). Sem CAIXA ALTA, sem mural de emojis, sem "definitivo/melhor/#1" a menos que o usuário possa provar.
   • Resumo: uma frase, com menos de 160 caracteres, utilizável como descrição curta da loja e snippet de busca.
   • Descrição: 3 parágrafos curtos: o problema nas palavras do comprador, o que este produto faz a respeito, como é usado (passos ou um exemplo curto).
   • O que tem dentro: lista de marcadores feita apenas a partir do inventário do passo 1, com contagens reais.
   • Para quem é / não é: 2-4 marcadores cada. "Não é para" gera confiança e reduz reembolsos.
   • Requisitos: software, versões, contas, nível de habilidade.
   • FAQ: 4-6 perguntas que um comprador realmente faria (formato, reembolsos, atualizações, compatibilidade, licença, suporte). Responda apenas com fatos que o usuário confirmou; caso contrário, marque como [PERGUNTAR AO USUÁRIO].
   • Tags: 8-12 frases de busca em minúsculas que as pessoas digitariam, sem nomes de concorrentes ou marcas, a menos que como compatibilidade.
4. Execute checklists/claims-check.md sobre o rascunho e corrija cada ocorrência.
5. Marque lacunas. Qualquer fato que você não pôde verificar permanece como [PERGUNTAR AO USUÁRIO: ...] no texto. Não preencha com um palpite.
6. Escreva listing.md, depois dê ao usuário um resumo de 3 linhas no chat: título escolhido, número de itens [PERGUNTAR AO USUÁRIO], qualquer coisa da verificação de reivindicações sobre a qual você não tinha certeza.

Saída

listing.md com as seções: Opções de título, Resumo, Descrição, O que tem dentro, Para quem é, Para quem não é, Requisitos, FAQ, Tags, Perguntas em aberto.

Regras

• Cada número na listagem deve vir do inventário ou do usuário.
• Sem promessas de renda ou resultados ("ganhe $X", "garantido", "viralize"). Descreva o que o produto faz, não o que o comprador ganhará.
• Sem avaliações, depoimentos, contagens de compradores, "tempo limitado" ou "só N restam" inventados.
• Nomes de produtos de outras empresas aparecem apenas como fatos de compatibilidade ("funciona com ..."), nunca de forma que sugira endosso.
• Escreva para pessoas que leem rapidamente no celular: parágrafos curtos, palavras simples, sem mural de negrito.
• Nunca publique ou cole na loja você mesmo. O usuário faz isso.

Arquivos neste skill

• templates/listing-template.md — a estrutura a ser preenchida para listing.md.
• checklists/claims-check.md — linhas para procurar e corrigir antes de entregar.