Prostir

Caso 09

Um skill de documentação técnica: faça qualquer IA escrever docs no seu padrão e venda isso

Você pede pra IA escrever a doc e o que volta é genérico, fora do seu tom e sem os pré-requisitos — aí você reescreve tudo de novo. Aqui você empacota seu padrão de documentação num skill do Prostir: um SKILL.md com as suas regras (escreva pro objetivo do leitor, o tipo certo de doc, a sua terminologia, um checklist de revisão), mais references e evals. O Claude Code valida e publica num passaporte em tech-docs.skill.prostir.build. Qualquer pessoa — ou a IA dela — instala e escreve docs do seu jeito. Libere de graça pra construir seu nome, ou ponha preço no seu próprio Stripe e venda quantas vezes quiser.

01

Antes: a IA escreve docs genéricas e seu critério fica preso na sua cabeça

  • Você pede a doc pra IA. Volta genérica, fora do tom e sem os pré-requisitos — e você acaba reescrevendo do mesmo jeito.
  • Você explica as mesmas regras toda vez: o leitor, a estrutura, a terminologia. Um prompt longo se perde; nada fixa.
  • Seu critério, que custou caro pra construir, só existe na sua cabeça. Você cobra por hora, e o teto é esse.
02

O que você faz dentro do Claude Code (uns 20 minutos)

Você fica no seu terminal. O Prostir empacota, valida e publica o skill.

  1. 01
    Adicione o Prostir como servidor MCP no Claude Code.

    Um comando: claude mcp add prostir https://prostir.ai.prostir.build/mcp. Faça login uma vez.

  2. 02
    Crie o skill e traga seu padrão pra dentro.

    O Claude Code chama prostir_skills_create (slug tech-docs) e depois prostir_skills_import_files — cole seu SKILL.md, puxe de um repo no GitHub ou suba uma pasta. O ZIP é só transporte; é extraído, não guardado.

  3. 03
    Escreva as regras que importam.

    No SKILL.md: escreva pro objetivo do leitor, deixe os pré-requisitos claros logo no início, escolha o tipo certo de doc (tutorial / how-to / reference / explanation) e não misture, fixe sua terminologia e seu tom, exija exemplos testados, adicione um checklist de revisão. Coloque references/ e evals/.

  4. 04
    Valide.

    O prostir_skills_validate confere se há um SKILL.md, se o frontmatter é válido (name, description), se as references @file resolvem, se os scripts são seguros e se os evals passam. Corrija o que estiver travando.

  5. 05
    Defina como ele é compartilhado e vendido.

    Adicione um logo, escolha o acesso (aberto, por chave ou OAuth) e o preço (grátis, ou único / assinatura no seu próprio Stripe). Acesso e preço são separados.

  6. 06
    Publique e compartilhe o passaporte.

    O prostir_skills_publish gera uma versão imutável, no ar em tech-docs.skill.prostir.build. Quem compra (ou a IA dele) baixa o pacote pra dentro de .agents/skills/. Lance uma 1.1 quando quiser.

03

O que acaba ficando dentro do skill

Uma pasta Agent Skills. O Claude Code empacota e valida na sua frente.

doc skills/tech-docs/SKILL.md O frontmatter (name, description) mais suas regras: escreva pro objetivo do leitor, deixe os pré-requisitos claros, escolha o tipo certo de doc.
doc references/style.md Sua terminologia, seu tom (você vs nós), capitalização e formatação — o padrão que a IA tem que seguir.
doc references/review-checklist.md O que um revisor confere: pré-requisitos claros, exemplos testados, nada de conhecimento presumido, uma tarefa por seção.
data evals/evals.json Testes que provam que o skill escreve docs do seu jeito antes de você publicar uma versão nova.
04

Como isso fica de verdade no Claude Code

Prompt real, chamadas reais, resultado real.

Claude Code

Empacota meu guia de estilo de documentação como um skill no Prostir, slug tech-docs. Quero vender. Puxa o SKILL.md e as references do meu repo no GitHub.

prostir_skills_create

Criando o pacote do skill tech-docs (rascunho, só do dono). Reservando o slug.

prostir_skills_import_files

Importando do seu repo no GitHub: skills/tech-docs/SKILL.md mais references/ e evals/. O preview tá limpo — aplicando no rascunho.

prostir_skills_validate

Um SKILL.md, frontmatter válido (name, description), as references @file resolvem, os evals passam. Nada travando.

Põe preço único de $9 no meu Stripe, passaporte aberto e usa meu ícone lime.

prostir_skills_publish

Publicando a versão 1.0 — arquivo imutável. Único de $9 via seu Stripe Connect, acesso aberto. No ar em tech-docs.skill.prostir.build. ✓ Pronto.

No ar. Compartilhe https://tech-docs.skill.prostir.build — quem compra fecha no seu Stripe, baixa o pacote e joga em .agents/skills/. Lance uma 1.1 quando quiser.

Passport

https://tech-docs.skill.prostir.build · Instale em .agents/skills/tech-docs/

05

Depois: defina uma vez, venda várias

  • Qualquer pessoa com quem você compartilhar adiciona o skill, e a IA dela escreve docs no seu padrão — tipo certo de doc, pré-requisitos claros, sua terminologia — já no primeiro rascunho.
  • É versionado: corrija uma regra uma vez, lance uma 1.1, e toda instalação nova já vem com o padrão melhor.
  • Libere de graça pra construir seu nome, ou ponha preço no seu próprio Stripe e venda o mesmo skill várias vezes em vez de cobrar por hora.

O que você publica

Um skill do Prostir publicado em https://tech-docs.skill.prostir.build — um SKILL.md compatível com Agent Skills mais seus references e evals, versionado e imutável. Deixe aberto e gratuito, com acesso por chave, ou com preço único ou assinatura no seu próprio Stripe. Quem compra (ou a IA dele) baixa o pacote e joga em .agents/skills/. Defina uma vez, distribua ou venda quantas vezes quiser. Sem código.

Pronto para lançar?

Uma tarde da ideia ao link no ar.

Coloque o que só você tem. Escreva as regras em linguagem simples. Abra o link no ChatGPT, no Claude ou no seu site. Publique o agente que só você poderia publicar.

Precisa de escala sob medida, white-label ou setup dedicado? Fale com vendas.