agentleFS
glodyfimpaglodyfimpa/claude-skills/forfettario-tax-calculator/SKILL.md

forfettario-tax-calculator

Skill0 starsChanged yesterdayMITView on GitHub

Deterministic calculator for an Italian freelancer on the regime forfettario: imposta sostitutiva, INPS Gestione Separata contributions and real net income from the year's incassi, the certified ATECO profitability coefficient, the sanction of a late Gestione Separata payment (ravvedimento) and how much income the acconti already paid cover. Use when someone asks "quanto mi rimane davvero?", "calcola il mio netto reale", "quanto pago di tasse e INPS?", "che coefficiente ha il mio ATECO?", "quanto costa pagare l'INPS in ritardo?", "il primo acconto copre già le tasse?", or before deciding on acconti (metodo storico vs previsionale). Not for P.IVA ordinaria, IRPEF progressive rates, cedolare secca or Gestione Artigiani/Commercianti.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Every number comes from the functions in scripts/forfettario_calc.py, never from mental arithmetic or from an LLM: the rules are fixed by …

    line 9

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Forfettario Tax Calculator

Every number comes from the functions in scripts/forfettario_calc.py, never from mental arithmetic or from an LLM: the rules are fixed by law, so the calculation is deterministic. Each rule cites its primary source; parameters that change yearly (INPS rate, TUR) are inputs.

Calculation chain (Istruzioni Redditi PF 2026, fascicolo 3, quadro LM)

1. imponibile_lordo = incassi × coefficiente_redditivita        LM22-LM34, cash basis (compensi percepiti)
2. contributi_inps  = imponibile_lordo × aliquota_inps          GS base = LM34 col. 2, before contributions
3. imponibile_netto = max(imponibile_lordo − contributi_versati, 0)   LM35: contributions PAID in the year
4. imposta          = imponibile_netto × aliquota_sostitutiva
5. netto            = incassi − contributi_inps − imposta

contributi_versati are the GS contributions actually paid in the year (previous-year saldo plus current-year acconti), not the ones computed in step 2. When income changes between years the two differ a lot: always pass the real paid amount. Without it, the function uses step 2 as a steady-state approximation.

Usage

from scripts.forfettario_calc import (
    calculate, coefficiente_per_ateco, sanzione_ravvedimento_gs, incassi_coperti_da_acconti,
    format_breakdown,
)

coeff = coefficiente_per_ateco("62.10.00")                 # 0.67
r = calculate(20000, coeff, aliquota_sostitutiva=0.05, aliquota_inps=0.2607,
              contributi_versati=6000)
print(format_breakdown(r, fatturato=20000))

sanzione_ravvedimento_gs(3000, giorni=120, tur=0.0265)     # 26.14 (within 120 days: TUR only)
incassi_coperti_da_acconti(acconti_gs_versati=3000, acconti_imposta_versati=600,
                           contributi_versati=6000, coefficiente_redditivita=0.67,
                           aliquota_sostitutiva=0.05)      # {'gs': ..., 'imposta': ..., 'limite': ...}

Functions

FunctionWhat it returnsSource
calculate(fatturato, coefficiente, aliquota_sostitutiva, aliquota_inps, contributi_versati=None)imponibile lordo/netto, INPS, imposta, netto. fatturato = incassi of the year (name kept for compatibility)Istruzioni PF 2026 fasc. 3, LM22-LM36
coefficiente_per_ateco(code)certified coefficient; raises on unknown codesfasc. 3 coefficient table (allegato 2 L. 145/2018), ATECO 2007
sanzione_ravvedimento_gs(importo, giorni, tur)civil sanction for a late GS payment: TUR/year within 120 days in a single payment, TUR + 5,5 points after, cap 40%art. 116 c. 8 L. 388/2000; TUR from INPS circolari (2,65% from 16/09/2026, circ. 98/2026)
incassi_coperti_da_acconti(...)max incassi of the year already covered by the acconti paid (tax: 100% of the year's tax; GS: 80%, informative only)previsionale on the tax: art. 4 c. 2 DL 69/1989; GS acconti: 80% rule, fasc. 2 appendix
format_breakdown(result, fatturato)text breakdown rounded to 2 decimals—

Parameters

ParameterValueSource
aliquota_inps0.2607 (2026, not insured elsewhere); 0.24 if pensioner or insured elsewherecirc. INPS 8/2026
aliquota_sostitutiva0.15 standard; 0.05 for new activities, first 5 years (check eligibility)L. 190/2014
tur0.0265 from 16/09/2026circ. INPS 98/2026

Coefficient table (certified)

GroupATECO 2007Coeff.
Food and beverage industry10-110.40
Wholesale and retail trade45, 46.2-46.9, 47.1-47.7, 47.90.40
Street trade, food and beverages47.810.40
Street trade, other products47.82-47.890.54
Construction and real estate41-43, 680.86
Trade intermediaries46.10.62
Accommodation and food services55-560.40
Professional, scientific, technical, health, education, finance, insurance64-66, 69-75, 85, 86-880.78
Other economic activities (includes 62 software, 63, 93, 99)01-03, 05-09, 12-33, 35, 36-39, 49-53, 58-63, 77-82, 84, 90-990.67

What is NOT certified (do not apply)

  • Metodo previsionale on INPS Gestione Separata acconti: no primary source found (only the 80%-of-previous-income rule is written). incassi_coperti_da_acconti()["gs"] is informative.

Tests

python3 -m unittest tests.test_forfettario_calc -v

Chain with contributions paid, floor at zero, steady-state approximation, coefficient groups, ravvedimento within/after 120 days and cap, acconti coverage.

Caveats

  • Forfettario only. The 85.000 € cap on revenue is not enforced: check eligibility first.
  • Planning tool: official filings stay with the commercialista.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.