# Steuer Assistent

> <img src="banner.png" width="100%" alt="steuer-assistent banner">

- Skill: `ellmos-ai/steuer-assistent` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add ellmos-ai/steuer-assistent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/steuer-assistent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/steuer-assistent

---


<img src="banner.png" width="100%" alt="steuer-assistent banner">

# steuer-assistent -- Verweis-Skill

Dieser Skill ist ein **schlanker Verweis (Wrapper)** auf das eigenstaendige,
oeffentliche Modul-Repository
[`ellmos-ai/steuer-assistent`](https://github.com/ellmos-ai/steuer-assistent)
(MIT-Lizenz, public). Der eigentliche Skill lebt dort -- dieses Repository
verlinkt und dokumentiert nur die Installation.

## Was das Modul tut

`steuer-assistent` ist ein kleines, offline-first Python-Modul fuer
selbst-kategorisierte Werbungskosten-Belege (Arbeitnehmer-Werbungskosten):

- Belege erfassen (Kategorie, Betrag, Datum, optionale Notiz).
- Erfasste Werbungskosten centgenau nach Jahr summieren.
- Eine private, nicht-amtliche ZIP-Arbeitsunterlage exportieren (CSV +
  Zusammenfassung + Nicht-Amtlichkeits-Hinweis, ohne Belegdateien).
- Lokaler Store (Standard `%USERPROFILE%\.steuer-assistent\steuer.db`), kein
  Netzwerkzugriff, kein Cloud-Upload, kein Zugriff auf fremde Datenbanken.

## Grenzen (wichtig)

- **Keine Steuerberatung.** Das Modul prueft weder die steuerliche
  Abziehbarkeit einzelner Positionen noch erstellt oder uebermittelt es eine
  Steuererklaerung.
- Die offizielle elektronische Uebermittlung erfolgt ausschliesslich ueber
  ELSTER bzw. dafuer zugelassene Software -- nicht ueber dieses Modul.
- Scope: private Arbeitsunterlage fuer Arbeitnehmer-Werbungskosten; keine
  Gewerbe- oder Betriebsausgaben-Erfassung.

## Installation (generisch, ohne lokale Konkretpfade)

1. Modul klonen:
   ```bash
   git clone https://github.com/ellmos-ai/steuer-assistent.git <klon-pfad>
   ```
2. Modul installieren und pruefen:
   ```bash
   cd <klon-pfad>
   python -m pip install -e .
   python -B -m pytest tests -q -p no:cacheprovider
   ```
3. `<klon-pfad>/SKILL.md` in die eigene Skill-Umgebung uebernehmen (z. B.
   `~/.claude/skills/steuer-assistent/`). KEINE realen lokalen Pfade oder
   Hostnamen in eine versionierte Skill-Umgebung committen.
4. Store-Pfad bei Bedarf ueber `STEUER_ASSISTENT_DB=<pfad>` bzw.
   `--store <pfad>` anpassen; Standard ist das Benutzerverzeichnis.
5. Details zu CLI-Befehlen, Datenschutz und Grenzen: siehe README des
   Modul-Repos.

## Herkunft dieses Verweis-Skills

Dieser Wrapper wurde am 2026-07-23 als Showcase-Eintrag fuer das
`ellmos-ai/skills`-Repository vorbereitet. Es findet **keine
Code-Duplikation** statt -- Pflege und Versionierung bleiben allein im
Modul-Repo `ellmos-ai/steuer-assistent`.

## Changelog

### 0.1.0 (2026-07-23)
- Initialer Verweis-Skill auf `ellmos-ai/steuer-assistent`.