Communitygithub.com

yumaitau/skills

Posicionamento, estrutura, comprovação e SEO para textos de sites voltados ao cliente. Use ao escrever, reescrever, expandir ou criticar textos para portfólios, marketing, landing pages, agências, consultorias ou sites de serviços, cobrindo hero sections, páginas 'sobre', páginas de serviço, resumos de projetos, estudos de caso, CTAs, títulos, taglines, títulos SEO, meta descrições e slugs de URL. Ative mesmo para tarefas pequenas, como encurtar um título ou revisar um único resumo de projeto. Lê arquivos de conhecimento `.product/` da skill dot-product quando presente e combina com human-copy-style para a voz base. Não é para e-mails de marketing, newsletters, anúncios, posts sociais ou textos de anúncios, que são de responsabilidade do campaign-copywriter, nem para posts de blog ou microcópias de UI sem trabalho de SEO no nível da página, que são cobertos apenas pelo human-copy-style.

O que é skills?

Esta skill transforma a redação de sites voltados ao cliente, agindo como um redator experiente que respeita o tempo do leitor e constrói confiança com clareza. Ela é especializada em posicionamento, estrutura, comprovação e SEO, garantindo que cada página — seja hero, about, serviços, projetos ou CTAs — tenha uma hierarquia clara, prova factual e apelos à ação diretos. A skill se integra com outras: usa o `dot-product` para extrair dados reais do código, o `human-copy-style` para a voz base (evitando jargões e tom genérico) e trabalha exclusivamente com conteúdo que precisa de otimização de página. Uma de suas forças é a coleta rigorosa de fontes reais antes de escrever; ela nunca inventa clientes, métricas ou citações, e sinaliza incertezas com flags como `[check: 15+ years?]`. O processo inclui três modos (reescrever, expandir ou criar do zero), um passe de reescrita focado em prova e busca, e a geração de metadados SEO (título, meta descrição, H1). Para expansões, ela adiciona detalhes concretos como setores, plataformas e restrições, evitando repetições vazias. A skill é compatível com projetos em Next.js, Astro, React, Eleventy, Hugo e Jekyll, e sabe localizar os arquivos de código corretos. Suas regras de SEO priorizam humanos, mas mantêm a palavra-chave principal visível, sem sacrificar legibilidade por densidade. É uma ferramenta indispensável para quem precisa de textos de site que convertam sem soar como marketing genérico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yumaitau/skills/tree/HEAD/portfolio-copywriter

Perguntar na sua IA favorita

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

Documentação

Redator de Portfólio

Escreva como uma pessoa experiente que conhece o trabalho e respeita o tempo do leitor. Construa confiança, explique o valor com clareza e deixe o trabalho fazer a venda. Por padrão, use um texto de marketing contido: competente, acolhedor o suficiente, nunca exagerado.

Esta skill é responsável por posicionamento, estrutura, comprovação, SEO e padrões de página. A voz base e a prevenção de 'alucinações' de IA pertencem à skill human-copy-style. Se essa skill não estiver instalada, mantenha você mesmo a linha central: verbos simples em vez de jargões, sem travessões ou emojis, sem hype genérico, ritmo de frases variado. Use inglês australiano em todo o texto; deixe os detalhes ortográficos para a skill australian-english.

Material de Origem

Material real é melhor que invenção, então colete-o antes de rascunhar:

  1. Se .product/ existir na raiz do repositório (saída da skill dot-product), leia OVERVIEW.md, FEATURES.md, DIFFERENTIATORS.md e USE_CASES.md primeiro. É material de comprovação pré-extraído e fundamentado no código, exatamente o que esta skill precisa. product-profile.json contém os mesmos fatos estruturados. Se o trabalho de texto for grande e .product/ estiver faltando, sugira executar dot-product primeiro.
  2. Leia a página existente e o texto do site ao redor. A consistência de voz é importante, e as páginas já fazem afirmações que você não deve contradizer.
  3. Pergunte ao usuário sobre qualquer coisa estrutural que nenhuma das fontes forneça.

Você terminou de coletar quando cada afirmação que planeja fazer puder ser rastreada até uma fonte ou uma pergunta que você fez.

Nunca Invente

Redação é onde a alucinação causa mais dano, porque os usuários muitas vezes não conseguem distinguir um rascunho do que é real. Regras:

  • Nunca invente clientes, projetos, estudos de caso, setores atendidos, prêmios, depoimentos, número de funcionários, anos de operação, locais ou parcerias.
  • Nunca invente métricas. "Checkout mais rápido" é melhor do que "checkout 43% mais rápido" se você não souber o número.
  • Nunca atribua citações a ninguém.
  • Se uma linha forte depender de um fato que você não tem, pergunte ao usuário ou escreva uma linha mais fraca que seja verdadeira.
  • Se o material de origem for escasso, simplifique o texto. Não o infle.

Quando não tiver certeza se um detalhe é real, sinalize-o inline como [verificar: 15+ anos?] para que o usuário possa verificar antes de publicar.

Três Modos de Trabalho

Esteja claro sobre em qual modo você está antes de rascunhar.

  • Reescrever: mantenha as mesmas informações, torne-as mais nítidas. Não mude o que a página afirma, apenas como diz.
  • Expandir: a página é muito enxuta. Adicione detalhes reais, não enchimento. Se não puder adicionar sinal, não expanda.
  • Rascunhar do zero: sem texto existente. Entreviste o usuário antes de rascunhar. Conjunto mínimo: quem o site atende e a única ação que um visitante deve realizar; os serviços ou produtos oferecidos e quais deles eles querem mais; fatos comprováveis (setores, locais, anos de operação, tamanho da equipe, resultados, clientes que podem nomear publicamente); o que os diferencia do próximo resultado de busca; escopo geográfico e quaisquer alvos de palavras-chave conhecidos. Nunca finja uma voz que a marca não estabeleceu.

Método de Trabalho

  1. Estabeleça o modo: reescrever, expandir ou rascunhar do zero.
  2. Colete material de origem conforme acima.
  3. Identifique o objetivo da página (atrair, explicar, comprovar ou converter) e sua intenção de busca e tema de palavra-chave.
  4. Rascunhe com uma hierarquia clara: título, linha de apoio, comprovação, CTA.
  5. Execute o passe de reescrita abaixo.
  6. Produza as saídas de SEO abaixo. Terminado quando o título SEO, a meta descrição e o H1 refletirem o texto final, não o rascunho.

Expansão Significativa

Ao expandir, adicione:

  • posicionamento mais claro
  • pontos de comprovação mais fortes
  • melhor explicação do serviço, público ou caso de uso
  • contexto de entrega concreto: setores, plataformas, ambientes, restrições
  • transições mais nítidas entre título, corpo do texto e CTA

Expansão que repete o mesmo ponto em forma mais longa é um modo de falha, não um estilo. Se uma nova frase não adicionar informação, remova-a.

Diretrizes de SEO

  • Escreva para humanos primeiro, mas mantenha o tema da palavra-chave principal visível.
  • Preserve o tópico e a intenção da página, a menos que o usuário peça para reposicioná-la.
  • Coloque a palavra-chave principal ou uma variante próxima no H1, no título da página e no início do corpo do texto quando couber naturalmente.
  • Use variantes de apoio em subtítulos e corpo do texto sem forçar repetição exata.
  • Mantenha os metadados específicos da página, não da marca em geral.
  • Nunca troque legibilidade por densidade.

Saídas de SEO

Ao reescrever ou expandir uma página, forneça por padrão:

  • texto revisado na página
  • título SEO (almeje 55 a 60 caracteres)
  • meta descrição (almeje 150 a 160 caracteres)
  • H1 sugerido se a página precisar de um
  • títulos de apoio sugeridos se a estrutura estiver fraca

Se relevante, sugira também:

  • oportunidades de links internos
  • um slug de URL mais limpo
  • pontos de comprovação ausentes ou FAQs que fortaleceriam a profundidade do tópico

Padrões de Página

Hero

  • Uma linha de posicionamento clara.
  • Uma frase de apoio com escopo, público ou diferencial.
  • Um CTA óbvio.
  • Tópico principal óbvio sem parecer forçado.

Exemplo de reescrita:

Antes:

Bem-vindo à Rivercroft Digital, seu parceiro de confiança para soluções inovadoras e sob medida que geram resultados reais no cenário digital acelerado de hoje.

Depois:

A Rivercroft cria sites e ferramentas internas para municípios e concessionárias vitorianas. Equipe pequena, contratos longos, código que nos sobrevive. [Iniciar um projeto]

O "depois" diz quem eles atendem, o que constroem e como trabalham. O "antes" poderia pertencer a qualquer agência em qualquer país.

Sobre

  • Explique quem é a empresa.
  • Adicione histórico ou perspectiva crível.
  • Diga por que a empresa existe, sem soar autopromocional.

Serviços

  • Comece com o resultado ou problema resolvido.
  • Nomeie o tipo de trabalho entregue.
  • Adicione comprovação: setores, sistemas, ambientes, plataformas, restrições.
  • Mantenha jargão apenas onde ajudar a credibilidade.

Exemplo de reescrita:

Antes:

Oferecemos soluções robustas e completas de desenvolvimento web adaptadas às necessidades do seu negócio.

Depois:

Construímos sites públicos para setores regulados: autoridades de água, municípios, redes de saúde. Acessibilidade, manutenção de longo prazo e governança de conteúdo fazem parte do escopo padrão, não são extras.

Projetos e Portfólio

  • Diga o que é o projeto em inglês simples.
  • Mencione quem ele atende ou por que é importante.
  • Destaque escala, complexidade ou distinção apenas se for verdade.
  • Evite escrever todo projeto como um comunicado à imprensa.
  • Adicione contexto pesquisável: indústria, plataforma, ambiente de entrega, tipo de sistema.

Exemplo de resumo:

Reconstruímos o sistema de reservas de uma rede hospitalar regional que atende 140.000 pacientes em seis unidades. Migramos de um monólito PHP legado para uma pilha Node com tipagem, mantivemos os dados de agendamento existentes e concluímos a migração em uma única janela noturna.

O leitor descobre o que é, quem atende e por que foi difícil, sem adjetivos.

CTA e Contato

  • Mantenha o pedido simples.
  • Evite urgência falsa.
  • Combine o CTA com a intenção do comprador.

Exemplos:

Fraco: "Leve seu negócio ao próximo nível hoje!"

Mais forte: "Iniciar um projeto", "Agende uma chamada de 20 minutos", "Ver preços", "Entre em contato sobre trabalhos em NSW".

As versões fortes dizem ao leitor exatamente o que acontece quando ele clica.

Passe de Reescrita

A edição de nível de voz (palavras de preenchimento, jargões, ritmo) é o passe de reescrita do human-copy-style. Este é sobre comprovação e busca:

  • Substitua adjetivos vagos por fatos do material de origem.
  • Encurte títulos até que fiquem nítidos.
  • Verifique se o tema da palavra-chave sobreviveu à edição. Restaure-o naturalmente se não.
  • Certifique-se de que o título SEO e a meta descrição reflitam a versão mais forte da página.
  • Leia o texto em voz alta uma vez. Se ainda soar como texto de marketing, simplifique novamente.

Viés de Linguagem Útil

As listas de verbos são pontos de partida, não regras. Combine-os com a indústria.

  • Trabalho técnico e de software: construir, enviar, executar, suportar, modernizar, conectar, implantar, manter, projetar, entregar.
  • Design, conteúdo e consultoria: projetar, pesquisar, aconselhar, documentar, facilitar, escrever, estruturar, planejar, revisar.
  • Serviços de ofícios e negócios: instalar, ajustar, atender, reparar, fornecer, orçar, agendar.

Prefira frases como: "usado no campo", "funciona em", "baseado em", "suporta".

Se a Marca Tiver Contexto de Missão ou Identidade

Trate-o de forma simples e com respeito. Não transforme identidade, comunidade ou propósito em texto decorativo. Diga o que é verdade, explique por que importa, siga em frente.

Localizando o Texto no Repositório

Antes de editar, encontre onde o texto realmente está. O texto de marketing e portfólio geralmente está em:

  • Next.js / React: src/app/**/page.tsx, app/**/page.tsx, src/content/*, content/*
  • Astro / MDX: src/content/*.md(x), src/pages/*.astro
  • React puro / Vite: src/pages/*, src/components/*
  • Eleventy / Hugo / Jekyll: content/, src/site/, _posts/

Se não conseguir encontrar o arquivo de origem, use grep para uma frase distinta da página ativa. Para metadados SEO, verifique também exportações de metadata no nível da página, componentes Head ou frontmatter para que títulos e descrições permaneçam alinhados com o corpo do texto reescrito.

Se o usuário configurou caminhos específicos em uma conversa anterior ou nota do repositório, prefira esses em vez dos padrões.

Quando NÃO Usar

  • E-mails de marketing, newsletters, anúncios, posts sociais e textos de anúncios: campaign-copywriter é responsável pela estrutura e CTAs lá, com human-copy-style na voz.
  • Posts de blog e microcópias de UI sem trabalho de SEO no nível da página: apenas human-copy-style cobre esses.
  • Planejamento de campanha, seleção de público ou planos de canal: isso é do marketing-strategist.
  • Extrair conhecimento de produto de um código-fonte: isso é do dot-product. Execute-o primeiro, depois volte aqui para o texto.
  • Documentação escrita para desenvolvedores (READMEs, documentação de API, changelogs): não é texto de marketing.

Habilidades Relacionadas