case-study-writing

Visão geral

O que é a skill case-study-writing?

A case-study-writing é um fluxo guiado para criar estudos de caso B2B claros e confiáveis usando o framework STAR (Situation → Task → Action → Result). Ela é construída como uma skill do inference.sh para que o seu agente consiga pesquisar, esquematizar e redigir histórias de clientes que destacam resultados de negócios concretos.

Em vez de começar de uma página em branco, essa skill orienta o agente a:

• Definir a Situation e o contexto do cliente
• Explicar a Task ou desafio de forma concreta
• Descrever a Action (sua solução e implementação)
• Quantificar o Result com métricas, comparações antes/depois e elementos visuais

Para quem é esta skill?

Use a skill case-study-writing se você precisa produzir:

• Histórias de sucesso de clientes para SaaS, serviços ou produtos B2B
• Materiais de apoio a vendas que provem resultados concretos
• Estudos de caso de marketing para sites, apresentações ou campanhas
• Peças de portfólio para agências, consultores ou freelancers

Ela se encaixa em equipes de:

• Marketing e marketing de conteúdo
• Marketing para clientes e customer success
• Vendas e engenharia de vendas
• Agências e consultores B2B

Que problemas ela resolve?

Esta skill foi criada para resolver problemas comuns em estudos de caso:

• Histórias superficiais, sem impacto de negócios claro
• Rascunhos desestruturados que escondem os resultados mais importantes
• Métricas fracas ou ausentes, que prejudicam a credibilidade
• Falta de pesquisa sobre o setor e o contexto do cliente

Seguindo uma estrutura STAR fixa e as orientações de contagem de palavras do repositório, o agente mantém cada seção focada e garante que o comprimento total fique na faixa de 800–1200 palavras, equilibrando profundidade e leitura fluida.

Quando case-study-writing é uma boa opção?

Escolha esta skill quando:

• Você tem um produto ou serviço com resultados mensuráveis
• Precisa de uma estrutura de estudo de caso padronizada e alinhada à marca em várias histórias
• Quer que o seu agente use pesquisa e dados, em vez de linguagem de marketing genérica
• Planeja reutilizar os estudos de caso em apresentações de vendas, landing pages ou campanhas em redes sociais

Ela não é uma boa opção quando:

• Você só precisa de depoimentos curtos ou frases de efeito
• Está escrevendo documentação puramente técnica ou manuais de usuário
• Você não tem permissão para citar nomes de clientes, métricas ou resultados, e não consegue anonimizar essas informações

Como usar

Pré-requisitos

A definição da skill no repositório indica que ela foi projetada para rodar com o inference.sh CLI (infsh).

Você deve ter:

• Node.js instalado (para usar npx na instalação da skill)
• Acesso ao infsh CLI se pretende seguir o passo de pesquisa do Quick Start

Se você pretende usar o fluxo de pesquisa mostrado na fonte, instale o inference.sh CLI seguindo as instruções oficiais em:

• https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md

Passos de instalação

Use o comando de instalação do Agent Skills Finder para adicionar a skill ao ambiente do seu agente:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

Esse comando baixa a definição da skill case-study-writing e os arquivos de guia relacionados do repositório inferen-sh/skills, em guides/writing/case-study-writing.

Após a instalação, abra:

• SKILL.md para ver a descrição canônica e o fluxo de trabalho
• Quaisquer guias referenciados em guides/writing/case-study-writing para estrutura detalhada e exemplos

Fluxo de trabalho principal com STAR

Depois de instalada, você pode pedir ao agente para usar case-study-writing sempre que mencionar gatilhos como case study, customer story, success story, B2B case study ou client testimonial.

Um fluxo típico é:

1. Reunir insumos
   Passe ao agente:

   • Nome e setor do cliente (ou equivalente anonimizado)
   • Produto ou serviço utilizado
   • O principal desafio e quaisquer métricas conhecidas
   • Depoimentos ou anotações de entrevistas, se houver

2. Pesquisar o contexto do cliente (opcional, via infsh)
   O guia da SKILL mostra como usar o inference.sh CLI para pesquisa externa. Por exemplo:

   infsh login
   
   # Research the customer's industry
   infsh app run tavily/search-assistant --input '{
     "query": "SaaS customer onboarding challenges 2024 statistics"
   }'
   

   Você pode adaptar essa query ao setor do cliente (por exemplo, manufacturing, fintech, ecommerce) para coletar estatísticas e tendências atuais que fortaleçam as seções Situation e Task.

3. Redigir com a estrutura STAR
   A skill recomenda a seguinte estrutura aproximada, com estes comprimentos:

   • Situation (100–150 words) – Quem é o cliente, seu contexto e por que o status quo não era suficiente.
   • Task (100–150 words) – O desafio ou objetivo específico, descrito em termos de negócio (por exemplo, reduzir churn, melhorar a qualidade dos leads, encurtar o onboarding).
   • Action (200–300 words) – Que solução foi implementada, como funcionou e os principais passos de implementação que destacam seu produto ou serviço.
   • Result (100–200 words) – Resultados mensuráveis, com comparações antes/depois, prazos e KPIs principais.

   No seu prompt, peça ao agente para:

   • Seguir o framework STAR na ordem
   • Manter o texto total na faixa de 800–1200 palavras
   • Separar cada seção de forma clara

4. Adicionar métricas, elementos visuais e depoimentos
   A descrição da skill enfatiza:

   • Apresentação de métricas – Peça ao agente para evidenciar métricas como taxa de conversão, impacto em receita, tempo economizado ou redução de erro. Peça também sugestões de ideias visuais simples (por exemplo, gráfico de barras antes/depois, gráfico de funil) que um designer possa implementar depois.
   • Depoimentos de clientes – Se você fornecer anotações brutas de entrevistas, peça ao agente para sugerir de 1 a 3 citações fortes alinhadas às seções Task, Action e Result.

5. Planejar formatos de distribuição
   Com a narrativa principal aprovada, você pode solicitar ao agente (usando o mesmo contexto da skill) que adapte o estudo de caso para:

   • Um roteiro de PDF de vendas de uma página
   • Títulos de slides para uma apresentação comercial
   • Posts curtos para redes sociais destacando o principal resultado
   • Um resumo de estudo de caso para site ou blog

Adaptando a skill ao seu fluxo de trabalho

O repositório recomenda tratar a skill como um template de workflow, não um roteiro rígido. Você pode:

• Ajustar o tamanho das seções se seu setor exigir mais profundidade técnica
• Substituir as ferramentas de pesquisa do exemplo pelo que você já usa, em vez do tavily/search-assistant
• Integrar o esqueleto STAR ao seu CMS ou modelos de propostas

Ao configurar seu agente, faça o mapeamento das frases de gatilho preferidas (por exemplo, “draft customer success story” ou “write SaaS onboarding case study”) para case-study-writing, para que o fluxo seja ativado de forma consistente pela sua equipe.

FAQ

O que exatamente a skill case-study-writing faz?

A skill case-study-writing guia o seu agente por um fluxo estruturado de estudo de caso B2B usando o framework STAR. Ela enfatiza contexto baseado em pesquisa, definição clara do problema, explicação detalhada da sua solução e resultados sustentados por métricas, depoimentos e sugestões de elementos visuais.

Como faço para instalar a case-study-writing?

Execute:

npx skills add https://github.com/inferen-sh/skills --skill case-study-writing

Em seguida, abra o arquivo SKILL.md no repositório instalado para ver as instruções completas, incluindo o Quick Start e a tabela do framework STAR.

Eu preciso usar o inference.sh CLI (infsh)?

O guia da SKILL mostra comandos de exemplo usando o inference.sh CLI (infsh) para fazer pesquisas com tavily/search-assistant. Isso é recomendado se você quiser pesquisa automatizada sobre o setor, mas você também pode:

• Rodar fluxos de pesquisa semelhantes com suas próprias ferramentas, ou
• Fornecer ao agente pesquisas que você já tenha realizado.

A estrutura de case-study-writing em si (framework STAR e orientação de contagem de palavras) pode ser seguida mesmo sem usar o infsh.

Que informações devo preparar para ter melhores resultados?

Para obter estudos de caso robustos com a skill case-study-writing, prepare:

• Informações de contexto do cliente (setor, porte, localização, uso do produto)
• O principal desafio ou objetivo de negócio
• Detalhes de implementação (como seu produto/serviço foi utilizado)
• Resultados quantitativos (KPIs antes e depois)
• Quaisquer anotações de entrevistas ou depoimentos de clientes

Quanto mais ricos forem os insumos, mais específico e confiável será o estudo de caso final.

Posso usar a case-study-writing para histórias que não sejam B2B?

A skill é otimizada para cenários B2B com métricas de negócio mensuráveis. Você pode adaptá-la para B2C ou histórias de transformação interna, mas a estrutura, o tom e o foco em KPIs foram pensados especificamente para estudos de caso B2B.

Qual será o comprimento final do estudo de caso?

De acordo com as orientações do framework STAR no repositório, o tamanho recomendado é de 800–1200 palavras. Isso normalmente é suficiente para apresentar contexto, explicar sua solução e comprovar resultados sem cansar o leitor.

Esta skill é adequada para posts em redes sociais ou anúncios?

A case-study-writing é, principalmente, um fluxo de trabalho long-form, em formato de relatório. Ela é ideal para criar estudos de caso completos, que podem depois ser reaproveitados como:

• Trechos curtos para redes sociais
• Emails de prospecção de vendas
• Slides ou one-pagers

Para anúncios propriamente ditos ou conteúdo muito curto para redes sociais, pode ser interessante combinar esta skill com outras skills de copywriting mais especializadas e usar o estudo de caso como fonte.

Onde posso ver todos os arquivos e regras desta skill?

Depois da instalação, abra o diretório da skill no seu ambiente para visualizar:

• SKILL.md – descrição principal e orientações de uso
• Outros guias em guides/writing/case-study-writing

Use a aba de arquivos no seu Agent Skills Finder ou o editor local para inspecionar toda a árvore, incluindo referências aninhadas e materiais de apoio fornecidos pelo repositório.