Skip to content

l1nch-lab/german-tax-skills

v0.2.3MIT

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.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-historie takes plz as an alternative to ags, and gewerbesteuer and koerperschaftsteuer accept plz to look up the Hebesatz.

Added

  • A postal code that belongs to several municipalities answers with HTTP 409 PLZ_AMBIGUOUS and the list of candidates. SKILL.md tells the agent to show the candidates and repeat the call with the chosen AGS; call.py prints the same hint.

[0.2.2] - 2026-10-01

Fixed

  • call.py finds RAPIDAPI_KEY in a .env written by PowerShell 5.1 (UTF-8 with BOM). Before, the BOM hid the key on the first line.
  • call.py writes UTF-8 on Windows. Piped output used cp1252, so agents saw �247 BGB instead of §247 BGB and broken umlauts.
  • An agent that changed into the skill folder before calling call.py got "no API key" although the project had a .env. SKILL.md now says not to cd, and call.py names the cause when it happens.

[0.2.1] - 2026-10-01

Added

  • plugin.json at 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_KEY is found in the environment or the project's .env (hooks/key-hinweis.sh). It never reads or prints the key itself.

Fixed

  • SKILL.md tells 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: reads RAPIDAPI_KEY from 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.