writing-shape

Visão geral da skill writing-shape

writing-shape é uma skill conversacional de redação para transformar um “bolo” de markdown em um artigo pronto para publicação, uma decisão estrutural por vez. Ela é ideal para redatores, profissionais de marketing técnico e editores que já têm material de base, mas precisam de ajuda para encontrar o ângulo, a abertura e a forma final do texto.

Para que serve

Use writing-shape quando a tarefa não for “escrever do zero”, e sim “dar coerência a este material bruto”. Ela funciona muito bem com anotações de entrevistas, limpeza de transcrições, fragmentos de rascunho e textos técnicos que precisam de uma narrativa mais forte antes de serem finalizados.

Por que ela é diferente

A skill writing-shape faz mais do que resumir notas de origem. Ela pede que você escolha entre possíveis aberturas e, depois, constrói o artigo parágrafo a parágrafo enquanto discute a estrutura ao longo do processo. Isso a torna útil para textos em que sequência, ênfase e formato importam tanto quanto os fatos.

Melhor encaixe e limites

Ela é uma boa escolha para Technical Writing quando você quer um artigo legível a partir de uma entrada bagunçada, mas não substitui o julgamento de quem domina o tema. Se você precisa de texto polido sem discussão, um prompt genérico pode ser mais rápido; se você quer um processo editorial guiado, writing-shape é a melhor instalação.

Como usar a skill writing-shape

Instalação e configuração da sessão

Instale com npx skills add mattpocock/skills --skill writing-shape. Em seguida, inicie a sessão passando o arquivo markdown bruto e o caminho do artigo de destino, ou peça para ela escolher um se você ainda não tiver decidido. A skill espera que o material de origem seja tratado como somente leitura e que o arquivo do artigo seja relido antes de cada escrita.

Que entrada fornecer

O uso mais forte de writing-shape começa com três coisas: as notas brutas, o público-alvo e o resultado desejado para o artigo. Por exemplo, “estruture estas notas em um guia prático para novos platform engineers” é melhor do que “melhore isso”, porque dá à skill uma tese, um leitor e um nível de detalhe para otimizar.

Fluxo de trabalho sugerido

Comece pelo arquivo de origem, leia de ponta a ponta e deixe a skill propor 2–3 aberturas candidatas. Escolha a abertura que combina com a função real do artigo e continue em etapas, perguntando o que o leitor precisa ver a seguir. Esse ciclo é onde writing-shape é mais útil: ele mantém o artigo ancorado, sem impedir que você reposicione a estrutura conforme o rascunho ganha forma.

Arquivos para ler primeiro

Abra primeiro SKILL.md e, depois, verifique qualquer orientação próxima do repositório que a skill referencie, como README.md, AGENTS.md e metadata.json, se existirem. Neste repositório, o valor principal está no próprio SKILL.md, então a decisão prática não é “procurar ajuda oculta”, e sim “entender o ciclo de redação e adaptá-lo com clareza”.

FAQ da skill writing-shape

writing-shape funciona só com entradas em markdown?

Ela foi pensada em torno de arquivos markdown, mas o “bolo” também pode ser uma transcrição, notas ou prosa bruta convertida para markdown. O requisito principal é que a fonte possa ser lida como um corpo completo de material antes do início da estruturação.

Em que ela é diferente de um prompt normal?

Um prompt normal costuma pedir um rascunho final em uma única passagem. writing-shape conduz uma sessão editorial iterativa: escolha da abertura, sequência dos parágrafos e debates sobre o formato acontecem durante o processo, o que normalmente produz um artigo mais intencional a partir de entradas confusas.

writing-shape é boa para iniciantes?

Sim, desde que a pessoa consiga fornecer material de base e responder a algumas perguntas editoriais. Ela é especialmente útil quando iniciantes sabem o que têm em mãos, mas ainda não sabem como organizar isso em um artigo convincente.

Quando eu não devo usar?

Não use writing-shape quando o conteúdo já estiver rigidamente estruturado, quando não houver um material bruto real para moldar ou quando você precisar de um resumo pontual em vez de um artigo em desenvolvimento. Ela é mais valiosa quando o rascunho ainda precisa de uma decisão de forma, e não apenas de limpeza.

Como melhorar a skill writing-shape

Dê um briefing editorial mais preciso

Os melhores resultados com writing-shape vêm de uma promessa clara: para quem é o artigo, qual problema ele resolve e em que tipo de texto ele deve se tornar. Se você consegue nomear público e resultado logo no início, a skill consegue escolher uma abertura melhor e manter os parágrafos seguintes alinhados.

Envie material de origem melhor

Modo de falha comum: o material de base está amplo demais, repetitivo demais ou misturado com pesquisa irrelevante. Antes de acionar a skill, corte o ruído óbvio, mantenha juntos os trechos markdown mais relevantes e rotule as seções se a fonte tiver vários temas. Entradas melhores reduzem rascunhos ramificados e tornam a conversa de estruturação mais decisiva.

Itere na estrutura, não só na redação

Se o primeiro rascunho não ficar bom, não peça apenas por “texto melhor”. Em vez disso, ajuste a tese, reorganize os pontos ou mude as expectativas de formato do artigo. writing-shape melhora mais quando você revisa primeiro a forma do argumento e só depois as frases.

Preserve o arquivo do artigo

Como a skill espera que o documento do artigo seja relido antes de cada escrita, as edições devem permanecer nesse arquivo, e não ser tratadas no chat. Esse hábito protege as alterações do usuário, torna a colaboração mais segura e mantém writing-shape útil em sessões de redação mais longas.