ptbr-writer

_{instalar · usar · níveis · regras · desenvolvimento · créditos · versões · o site}

🇬🇧 Read in English

em um minuto

• Reescreve texto técnico em português brasileiro para leitura única: sujeito explícito, uma proposição por frase, termos consistentes. Serve a texto que pessoas e agentes leem.
• Cada pedido passa por um nível de rigor, e a skill declara o nível que assumiu.
• Não muda tese, autoria nem conclusão, e não busca fontes. Marca com ⚠ o que não checou.

Como ler esta figura

Em uma frase. Você escreve ptbr: …, e a skill escreve um texto por nível e por idioma.

Como ler. Da esquerda para a direita. A faixa de cima é o caminho de todo pedido; a de baixo, a configuração e os arquivos. A borda laranja marca onde você entra e o que você recebe.

Fora da figura. As regras, o nível smart-note e o pedido ptbr reconfigurar.

Evidência. docs/archify/em-um-minuto.json, a fonte da figura.

instalar

A versão oficial é a v0.3.0. Num terminal:

claude plugin install ptbr-writer --marketplace h0ffmann/ptbr-writer#v0.3.0

Para fixar a versão num repositório, ponha no .claude/settings.json dele o marketplace h0ffmann/ptbr-writer com "ref": "v0.3.0" em extraKnownMarketplaces e ative ptbr-writer@ptbr-writer em enabledPlugins. Para atualizar, troque a tag.

OpenCode

O script scripts/install-opencode.sh instala as skills e o plugin do ask-levels a partir de uma tag. ⚠ Ele entra na próxima release; até lá, rode o script de um clone.

Chrome

Uma extensão, ainda sem release, sublinha no campo onde você escreve o que o nível pede para mudar.

1. Rode just ext-build.
2. Em chrome://extensions, ligue o Modo do desenvolvedor e carregue extension/dist/.
3. No popup, escolha o provider e o modelo e clique em Salvar.

Nada muda no texto sem o seu clique em Aceitar. O vermelho marca ortografia, pontuação, concordância e as demais regras; o amarelo, uma frase reorganizada (cartão Reescrita). Nas configurações: o tom, o quanto corrigir, a espera e a lista "nunca corrigir" (Sempre ignorar). O Firefox 128+ usa just ext-build-firefox (guia). Os providers:

• Claude ou DeepSeek: com a sua chave.
• Ollama (local): just ext-ollama serve um modelo nesta máquina, sem chave.
• Ollaya (local, só aponta): just ext-ollaya serve um modelo de decisão. Ele aponta a regra que cada frase quebra e não escreve a troca.
• Ollaya + Ollama: com o Ollama, a chave Ollaya escolhe o estilo faz o Ollaya escolher o tom (conciso, socrático, amigável) em que o Ollama escreve.

⚠ Os providers locais não foram medidos em pt-BR.

usar

Comando	Faz
/ptbr-writer:ptbr	reescreve no nível pedido, ou classifica o texto e declara o nível
/ptbr-writer:cientifico	texto científico com fontes: artigo, proposta, relatório
/ptbr-writer:bipr	abre o PR do branch com o corpo em pt-BR e o espelho em inglês

Ou descreva a tarefa: "reescreva este runbook em português controlado".

Um pedido que começa com ptbr usa o ptbr-writer.toml. Na primeira vez, o Claude pergunta os níveis, os formatos, a pasta e os idiomas, e grava as respostas:

levels = ["estrito"]     # vazio: a skill classifica e declara o nível
formats = ["md", "pdf"]  # txt, md, pdf, notes
folder = "docs"
languages = ["pt-BR"]    # e/ou "asd-ste100"

Para mudar, edite o arquivo ou escreva ptbr reconfigurar. O pedido vence o arquivo: ptbr leve: ... usa leve. Os arquivos se chamam ptbr-writer-<data>-<objetivo>-<nível>.<ext>.

níveis

Nível	Uso
estrito	runbooks, procedimentos, saídas para agentes
descritivo	documentação de sistema
leve	comunicados internos
científico	artigos, propostas, relatórios técnicos com fontes
smart-note	notas para um segundo cérebro; combina com outro nível

Warning

Um nível de autor, ainda planejado, imita o estilo e nunca copia texto (REUSE.md).

regras

As regras PTW-1 a PTW-17 estão na SKILL.md. A skill cientifico acrescenta as regras CIE. O site mostra cada regra com a sua origem, o roadmap, os projetos relacionados e as figuras:

• Fluxo do plugin do Claude Code
• Fluxo da extensão de navegador
• Fluxo do modelo local
• De onde vem o .pdf

O whitepaper, em 8 páginas, está em WHITEPAPER.pdf e, em inglês, em WHITEPAPER.en.pdf.

tempo de leitura

Todo texto que o plugin gera traz uma estimativa de leitura, calculada pelo binário ptbr-reading-time, nunca de cabeça. Este README tem um limite de 10 minutos, que o just quality confere.

desenvolvimento

Requisito: Nix com flakes. As regras para quem contribui, pessoa ou agente, estão no AGENTS.md.

nix develop      # o shell de desenvolvimento
just quality     # tudo o que o CI checa

créditos

• PTW-1 a PTW-8: o PTC de @kayquer (MIT).
• PTW-9 a PTW-13: a skill ouro-paper de marola-dev/marola-research e o "Audience and evidence" de h0ffmann/ww3-gpu.
• PTW-14 a PTW-17: pedido de @robkler.
• Skill científica: scientific-writing de K-Dense-AI/scientific-agent-skills (MIT, Copyright (c) 2025 K-Dense Inc.) e artigo de labdaps/labskills (MIT, Copyright (c) 2026 LABDAPS), em palavras próprias. Citação pedida: Kassis, T. et al. (2026), Scientific Agent Skills, arXiv:2609.00065.
• smart-note: Sönke Ahrens, Niklas Luhmann e Robert M. Pirsig. Retórica: Platão e Pirsig.
• Nível por autor: a skill orwell-writing de @tamdogood (MIT).
• Tempo de leitura: Brysbaert (2019), Journal of Memory and Language 109, 104047.
• Extensão de navegador: @robkler, no #51.
• Figuras: Archify, de @tt-a1i (MIT). Plugin e roteamento: marola-dev/marola-devkit, de @brunogbv.
• Site: Lustre (MIT), a stdlib do Gleam (Apache-2.0), fontes do Google Fonts (SIL OFL), e a bandeira e a assinatura de Machado de Assis do Wikimedia Commons, em domínio público.

Os commits fixados de cada fonte estão no AGENTS.md.

licença

MPL-2.0. Veja LICENSE. Quem distribuir um arquivo modificado do ptbr-writer publica esse arquivo sob a MPL. As versões anteriores à v0.3.0 continuam MIT. O que vem de terceiros mantém a licença e o aviso de cada um.

_{ptbr-writer é um fork conceitual e independente do Português Técnico Controlado (PTC), de kayquer (MIT). A metodologia e as regras originais são de lá.}