l1nch-lab/german-tax-skills
v0.2.6MIT
Calculate German taxes, social security contributions and benefits (Brutto-Netto, Lohnsteuer, Einkommensteuer, Minijob, Abfindung, Kurzarbeitergeld, Elterngeld, Bürgergeld, Hebesätze and 100+ more) through the rechner-hub.de API on RapidAPI instead of estimating them.
Changelog
[0.2.6] - 2026-10-27
Changed
- Endpoint reference regenerated against the live API (version 2026.52).
fruehstartrentenow cites the FrühStRG as passed by the Bundestag on 16.10.2026 (BT-Drs. 21/7864, 21/8606) instead of the ministry draft; the Bundesrat's consent is still pending.
Fixed
tools/build_reference.pylabels decimal fields asnumberagain. Since pydantic 2.14 the API schema drops the pattern on the string branch of decimal fields, and the generator only folded that branch away when the pattern was present, so 70 endpoint files would have shownnumber | string.
[0.2.5] - 2026-10-17
Added
- Two endpoints, now 122:
riestercomputes the subsidy of an existing Riester contract for one contribution year (minimum own contribution from the previous year's income, basic and child allowances, the spouse's allowance, special-expenses deduction with the most-favourable test), andpolicenvergleichcompares a gross-premium against a net-premium private pension policy at equal contributions.
Changed
- Endpoint reference regenerated against the live API (version 2026.52, addendum).
altersvorsorgedepottakeszve,zusammenveranlagung,ehepartner_mittelbarandvorjahreseinkommen, returnszve_angesetztand the spouse's allowance, and compares against a Riester contract that stays under the old law.minijobis pension-insured by default with the employee's share and takesrv_befreitfor the exemption. - CI runs the tests on Ubuntu only.
[0.2.4] - 2026-10-09
Changed
- Endpoint reference regenerated for API version 2026.52.
renteandrentenlueckereturn the net pension after health and long-term care insurance and income tax instead of a flat 85 %,rentecomputes pension points per § 70 SGB VI (lower pension whenlohnwachstum> 0),szenario/jobwechseltakesversicherungsmonate,altersvorsorgedepottakeskinder_vor_2008, andkrankenkassenbeitragacceptskv_zusatzbeitragas an alias. Four response fields carry a new name and the old one is marked deprecated in the reference (stkl_vergleich_netto,mehrkapital_eigenbeitraege_rente,ohne_kest,preis_mit_regulaerer_ust).
Added
- A municipality name that matches several municipalities and none exactly answers with HTTP 409
GEMEINDE_AMBIGUOUSand the list of candidates (gewerbesteuer, its batch,koerperschaftsteuer).SKILL.mdtells the agent to show the candidates and repeat the call with the chosen AGS;call.pynames the municipality case in its hint instead of the postal-code text.
[0.2.3] - 2026-10-05
Changed
- Endpoint reference regenerated for API version 2026.51. The municipal endpoints (
mietstufe,einkommen,schulden,finanzamt,grundsteuer-monitor,pv-ertrag,bauland,zensus/wohnungen) take a 5-digit postal code in place of the AGS,hebesaetze-historietakesplzas an alternative toags, andgewerbesteuerandkoerperschaftsteueracceptplzto look up the Hebesatz.
Added
- A postal code that belongs to several municipalities answers with HTTP 409
PLZ_AMBIGUOUSand the list of candidates.SKILL.mdtells the agent to show the candidates and repeat the call with the chosen AGS;call.pyprints the same hint.
[0.2.2] - 2026-10-01
Fixed
call.pyfindsRAPIDAPI_KEYin a.envwritten by PowerShell 5.1 (UTF-8 with BOM). Before, the BOM hid the key on the first line.call.pywrites UTF-8 on Windows. Piped output used cp1252, so agents saw�247 BGBinstead of§247 BGBand broken umlauts.- An agent that changed into the skill folder before calling
call.pygot "no API key" although the project had a.env.SKILL.mdnow says not tocd, andcall.pynames the cause when it happens.
[0.2.1] - 2026-10-01
Added
plugin.jsonat the repository root in the Agent Plugins format, so the plugin installs in the GitHub Copilot CLI. The Claude Code manifest in.claude-plugin/stays the source; CI checks that both agree.
[0.2.0] - 2026-09-28
Added
- Claude Code plugin: a one-time hint at session start when no
RAPIDAPI_KEYis found in the environment or the project's.env(hooks/key-hinweis.sh). It never reads or prints the key itself.
Fixed
SKILL.mdtells agents other than Claude Code (Codex, Cursor, Copilot, Gemini CLI …) to replace${CLAUDE_SKILL_DIR}with the skill folder. Before, the shell expanded it to an empty string and the script call failed.
[0.1.0] - 2026-09-28
Added
- Skill
steuerrechner-api: routes German tax, social security and benefit questions to the rechner-hub.de API on RapidAPI. - Endpoint reference for 120 endpoints, generated from the OpenAPI spec.
call.py: readsRAPIDAPI_KEYfrom the environment or.env, masks the key in all output, reports remaining quota and tells a used-up plan quota apart from a short-term rate limit.- Claude Code plugin and marketplace manifests.