gramatico
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.
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.4.1. Num
terminal:
claude plugin install gramatico --marketplace piabrota/gramatico#v0.4.1
Para fixar a versão num repositório, ponha no .claude/settings.json dele o marketplace
piabrota/gramatico com "ref": "v0.4.1" em extraKnownMarketplaces e ative
gramatico@gramatico 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.
- Rode
just ext-build.
- Em
chrome://extensions, ligue o Modo do desenvolvedor e carregue extension/dist/.
- 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.
Desktop
Um app para Linux, macOS e Windows (Tauri 2, Rust na janela e no núcleo): você cola um texto, escolhe o
nível e clica em Revisar. Ele usa a revisão da extensão, com os mesmos providers, sublinhados e
cartões. A release traz os instaladores, com o .sha256 de cada um (⚠ ainda não rodou numa tag); o do
macOS é arm64, sem notarização: abra por Privacidade e Segurança → Abrir Mesmo Assim.
- Rode
just app-bootstrap: instala o Rust, o tauri-cli e o wasm-bindgen-cli fixados em app/.tools.
- Rode
just app-dev para abrir o app, ou just app-build para gerar o instalador deste sistema.
- Em Configurações, escolha o provider e o modelo e clique em Salvar.
A chave fica no settings.json da pasta de configuração do app, com modo 0600.
just app-screenshot tira a foto da janela com um provider falso, sem chave e sem rede.
Android
O mesmo app no Android, ainda sem release, com uma sobreposição: em qualquer app, ela revisa o campo
em que você digita, sublinha o que uma regra pede para mudar e abre as correções por um selo no canto
do campo (Aceitar, Ignorar, Pausar neste app). No Android só há a Claude: o texto vai do
celular à Anthropic, com a sua chave. Campos de senha nunca são lidos. A chave fica fora do backup; num
APK de debug, adb shell run-as a lê.
- Rode
just app-android-bootstrap: precisa do Android SDK (ANDROID_HOME) e de um JDK 17 ou mais novo.
- Rode
just app-android-build e instale o APK de app/target/android com adb install.
- No app, cole a chave da Claude em Configurações e toque em Ativar nas configurações do Android.
just app-android-screenshot tira as fotos num emulador, com uma Claude falsa. ⚠ Num celular de
verdade, com uma chave real, ainda não foi testado. Para a Play Store, um serviço de acessibilidade que
não é para acessibilidade precisa de uma declaração do Google (⚠ a política não foi conferida aqui); o APK é
de debug, para instalar à mão.
usar
| Comando | Faz |
|---|
/gramatico:ptbr | reescreve no nível pedido, ou classifica o texto e declara o nível |
/gramatico:cientifico | texto científico com fontes: artigo, proposta, relatório |
/gramatico: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:
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.
- Ícone: um G desenhado à mão em Nix puro, com a caneta de piabrota/nix-os (
drawings/pen.nix, vinda
do pirsig); veja docs/drawings.
- 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 gramatico 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.
gramatico é 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á.
