emitir-nfse
Skill0 starsChanged 59 days agoMITView on GitHub
Emite NFS-e (Nota Fiscal de Serviço Eletrônica) pelo Emissor Nacional (gov.br) via Playwright MCP, para qualquer empresa do Simples Nacional cujo município já usa o padrão nacional. Use quando o usuário pedir "emitir nota fiscal", "emitir NFS-e", "tira uma nota pra fulano" ou variações. A skill pergunta tomador, valor e data de competência, preenche as 4 abas do portal, PARA na revisão e só clica "Emitir NFS-e" depois do OK explícito. O download do DANFSe/XML fica com o usuário (o portal exige hCaptcha).
1 other project uses a version of this.
Adopted by
Most recently taken up by
- caiopizzol/tres-pinostheir own version, first seen Nov 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- caiopizzol/tres-pinos★ 7same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- deep-researchSkill
- excalidrawSkill
- folder-organizerSkill
- ig-competitor-researchSkill
- image-prompt-generatorSkill
- memorySkill
- roastSkill
- screenwatchSkill
- site-builderSkill
- slide-creatorSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 44
Data de competência: default = hoje. Confirmar.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Emitir NFS-e (Emissor Nacional gov.br via Playwright)
Automatiza a emissão de NFS-e no Portal Nacional (https://www.nfse.gov.br/EmissorNacional)
usando o Playwright MCP. Pensada para quem emite as mesmas notas todo mês: o
prestador, o código de serviço e a tributação ficam fixos em nfse.config.json,
e a cada nota só mudam tomador, valor e data de competência.
Antes do primeiro uso (setup, uma vez)
- Playwright MCP instalado no Claude Code / Codex (
@playwright/mcp). - Copie
config.example.jsonparanfse.config.json(na pasta da skill) e preencha com os dados da SUA empresa. Vejareferences/playbook.mdpara o significado de cada campo. - Valide os campos fiscais com o seu contador (código de tributação, NBS, CST de PIS/COFINS, IBS/CBS). A skill só repete o que está na config: se a config estiver errada, todas as notas saem erradas.
- Opcional (Windows): guarde a senha do gov.br num cofre criptografado rodando
no seu terminal
powershell -File scripts/set-nfse-secret.ps1. Sem o cofre, a skill pede para você digitar a senha na janela do navegador. - Opcional: copie
references/tomadores.example.mdparareferences/tomadores.mde cadastre seus clientes recorrentes.
Se nfse.config.json não existir, a skill NÃO abre o portal: ela ajuda o
usuário a preencher a config primeiro.
Regra de ouro
Trazer os dados → mostrar a revisão → emitir SÓ com aprovação explícita. Nunca clicar "Emitir NFS-e" sem o OK do usuário depois de ele revisar o resumo.
Inputs a coletar (antes de abrir o portal)
Para cada nota:
- Tomador: nome do cliente. Resolver pelo
references/tomadores.mdse existir; senão pedir o CNPJ (o portal puxa razão social e endereço pela lupa da Receita). - Valor do serviço em reais (ex.: R$ 2.000,00).
- Data de competência: default = hoje. Confirmar.
Se o usuário já passou tudo na mensagem ("emite pra Cliente X, 2000, hoje"), não re-perguntar: seguir para o preenchimento e a revisão.
Workflow
Procedimento detalhado, selectors e pegadinhas em references/playbook.md.
- Login: abrir
https://www.nfse.gov.br/EmissorNacional. Se cair em/Login, pré-preencher o CNPJ da config e logar pelo cofre (references/login-cofre.md) ou pedir para o usuário digitar a senha e clicar Entrar na janela do Playwright. - Emissão: navegar para
/EmissorNacional/DPS/Pessoas. - Aba Pessoas: IBS/CBS conforme a config (PRIMEIRO, ver pegadinha 13), data de competência via JS, regime de apuração, tomador no Brasil, CNPJ do tomador digitado via teclado, lupa, conferir razão social. Avançar.
- Aba Serviço: município de prestação (buscar pelo nome da config no Select2, nunca injetar código), código de tributação (buscar na Select2), imunidade ISSQN = Não (marcar explícito), descrição e NBS da config. Avançar.
- Aba Valores: valor via teclado, retenção de ISSQN, tipo de tributos, tributos aproximados, PIS/COFINS, tudo da config. Avançar.
- Aba Emitir: extrair resumo + screenshot. PARAR. Mostrar a tabela de revisão (prestador, tomador, competência, serviço, valor, líquido) e pedir aprovação.
- Após aprovação: clicar
#btnProsseguir("Emitir NFS-e"), capturar a Chave de Acesso da tela de sucesso e reportar.
Várias notas na mesma sessão: repetir o ciclo (o login persiste).
Download do DANFSe/XML (fica com o usuário)
O download exige resolver um hCaptcha. A skill não tenta resolver
captcha: ela orienta o usuário a resolver e baixar na janela do Playwright,
salvando na pasta pastas.notas da config, com o nome = Chave de Acesso.
Limites
- Só funciona para municípios que já aderiram ao Emissor Nacional. Se a sua cidade usa um portal próprio, a skill não serve.
- Testada para Simples Nacional. Outros regimes têm campos que a skill não cobre.
- O cofre de senha usa DPAPI (Windows). Em Mac/Linux, use o login manual.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

