Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add pproenca/dot-skills --skill pt-irs-runbookgit clone --depth 1 https://github.com/pproenca/dot-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/pproenca/dot-skills/pt-irs-runbook)<a href="https://agentmods.dev/skills/pproenca/dot-skills/pt-irs-runbook"><img src="https://agentmods.dev/badge/skills/pproenca/dot-skills/pt-irs-runbook/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/pproenca/dot-skills/pt-irs-runbook"><img src="https://agentmods.dev/badge/skills/pproenca/dot-skills/pt-irs-runbook.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00131 | $0.01503 |
| Opus 5 | $0.00066 | $0.00751 |
| Sonnet 5 | $0.00026 | $0.00301 |
| Haiku 4.5 | $0.00013 | $0.00150 |
Grade A, and why
pt-irs-runbook scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 91 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Portugal IRS Filing Runbook
A diagnostic runbook for Portuguese personal income tax (IRS). Each symptom is a filing situation; each decision tree routes from the situation to the correct annex, autonomous rate, and deadline, then terminates in a concrete filing action or a clear "escalate to a contabilista certificado for {reason}".
Not tax advice. This skill encodes the CIRS and Portal das Finanças rules as verified on the cited dates. Tax rates and thresholds change with each Orçamento do Estado. Always confirm figures against the live Art. 68/72 text and the official Modelo 3 / IRS automático screens before submitting, and involve a contabilista certificado for anything non-routine. Default income year is 2025 (return filed 1 Apr – 30 Jun 2026) unless stated otherwise.
When to Apply
- The user asks how to file a Modelo 3 (PT annual income tax return) or which annexes apply to their income.
- The user needs to know whether they are a PT tax resident or non-resident, and what that changes.
- The user receives Portuguese-source income — rent, a property/share sale, salary, pension, or self-employment fees — and must declare it.
- The user is a non-resident landlord (or has foreign income as a resident) and needs the right rate plus double-taxation relief.
- The user asks about a specific PT regime: IRS automático, IRS Jovem, IFICI (the post-NHR regime), englobamento, mais-valias reinvestment.
This skill is Portugal-specific. For UK/other-country filing it is out of scope (though it covers the PT side of a cross-border situation, e.g. PT rental income that also appears on a UK SA106).
How to Use
- Always start at residency. Read residency-tree. Residency status (Art. 16) determines the entire regime — worldwide vs PT-source-only income, progressive vs flat rates, deductions vs none.
- Then check whether a return is even required and which annexes: filing-obligation-tree.
- Open the tree for each income type the user has. A taxpayer often needs several annexes at once.
- Look up every rate/threshold in one place: rates-and-deductions.md is the single source of truth; the trees link to it rather than restating numbers.
- Estimate figures deterministically with the calculators in references/queries/ (day-count, rental tax, capital gain), then verify on Portal das Finanças.
- Summarise the outcome with assets/templates/report.md.
What ships with it
16 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/templates/report.md 2.1 KB
- config.json 1.6 KB
- gotchas.md 2.1 KB
- metadata.json 1.5 KB
- references/capital-gains-tree.md 3.8 KB
- references/employment-pension-tree.md 2.3 KB
- references/filing-obligation-tree.md 4.9 KB
- references/foreign-income-tree.md 4.0 KB
- references/queries/property-capital-gain.py 3.7 KB runs code
- references/queries/rental-tax-estimate.py 4.4 KB runs code
- references/queries/residency-days.py 3.7 KB runs code
- references/rates-and-deductions.md 8.4 KB
- references/rental-income-tree.md 4.3 KB
- references/residency-tree.md 4.7 KB
- references/self-employment-tree.md 2.8 KB
- references/symptoms.md 3.1 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 6d ago First seen · 91 lines · 131 tokens per session scan A 7382059bdc0c
pt-irs-runbook is a skill published in the GitHub repository pproenca/dot-skills (205 stars, last pushed 24d ago), licensed MIT. It adds 131 tokens to every session and 1,503 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
audit-support
Support SOX 404 compliance with control testing methodology, sample selection, and documentation standards. Use when generating testing workpapers, selecting audit samples, classifying control deficiencies, or preparing for internal or external audits.
kyc-doc-parse
Parse an investor or client onboarding packet into structured KYC fields — identity, ownership, control, source of funds, and document inventory. Use as the first step of KYC screening; output feeds the rules engine.
fiscaliste
Fiscaliste IA pour la fiscalité personnelle des particuliers français : optimisation et déclaration de l'impôt sur le revenu, IFI, revenus du capital, revenus fonciers, equity salarial, crypto-actifs et PER. Couvre le calcul de l'IR (barème, quotient familial, décote, PAS, CEHR, revenus exceptionnels), la déclaration…
regulatory-analysis
Analyzes documents and processes against FINRA, SEC, Federal Reserve, and CFPB regulatory frameworks. Identifies compliance gaps, classifies findings by severity, and recommends remediation. Use when performing compliance audits, regulatory reviews, gap analyses, or verifying policy adherence to financial regulations.
subcontractor-payment-tracker
Track subcontractor payments, lien waivers, and compliance. Manage payment schedules and documentation.
tax-optimizer
Tax optimization strategies including tax-loss harvesting, wash sale rule navigation, asset location optimization, Roth conversion analysis, and charitable giving strategies.