trader-steuer

Befehle: Die vollständigen Aufrufe unten gelten für die Plugininstallation. Bei einzeln nach .claude/skills/ kopierten Ordnern entfällt der Präfix trader-skill-deutsch:. Verwende beim Wechsel zu einem anderen Skill den in deiner Sitzung tatsächlich angebotenen Namen.

Wichtig vorab: Die Regeln in diesem Skill sind US-Steuerrecht (cost basis, wash sale, tax-loss harvesting). Für Privatanleger in Deutschland gilt die Abgeltungsteuer, und die funktioniert anders: Es gibt keine Wash-Sale-Regel und keine Unterscheidung nach kurz- und langfristiger Haltefrist wie in den USA. Dieses Tool ersetzt keine Steuerberatung. Es rechnet nur mit den Lots, die du ihm gibst, nach US-Regeln. Sag das einmal, früh, in jeder Antwort, die diesen Skill nutzt.

Der Steuer-Helfer rechnet mit den Lots des Nutzers, damit niemand blind verkauft. Er entscheidet nie, was für die Steuern des Nutzers richtig ist. Das ist keine Steuerberatung und auch keine Anlageberatung: Was für den Nutzer gilt, entscheidet eine Steuerberatung.

${CLAUDE_SKILL_DIR} unten ist der Ordner dieses Skills (dort liegt diese SKILL.md).

python3 "${CLAUDE_SKILL_DIR}/lots.py" report --lots              # jedes Lot, Gewinn oder Verlust, Frist
python3 "${CLAUDE_SKILL_DIR}/lots.py" sell KO 2 --price 90.11    # was ein Verkauf realisieren würde (FIFO)
python3 "${CLAUDE_SKILL_DIR}/lots.py" sell KO 2 --method specific --lots KO-2
python3 "${CLAUDE_SKILL_DIR}/lots.py" harvest --min-loss 100     # Kandidaten, mit Wash-Sale-Prüfung
python3 "${CLAUDE_SKILL_DIR}/lots.py" harvest --min-loss 100 --write
python3 "${CLAUDE_SKILL_DIR}/lots.py" wash KO                    # wäre ein Kauf von KO heute ein Wash Sale?

Was er liest und schreibt

Die Lots kommen aus den Ausführungen, die trader-broker einträgt (ticket.py fill), oder aus dem Depotauszug des Nutzers. Hat eine Position Aktien, aber keine Lots, frag nach Kaufdaten und Kosten. Erfinde nie einen Einstandswert.

Die Regeln, die er anwendet (US-Bundessteuer, nur Rechnung)

Modellgrenzen: Dies ist eine Lot-Rechnung und konservative Konfliktsuche, kein vollständiges US-Steuerbuch. Mehrere Verkäufe können dieselben Ersatzaktien berühren; deren eindeutige Zuordnung über Transaktionen, später eintreffende Käufe sowie die Anpassung von Einstandswert und übertragener Haltefrist werden nicht automatisch fortgeschrieben. sell --record reduziert die verkauften Lots und protokolliert den Verkauf, korrigiert aber nicht automatisch die Ersatz-Lots. Den Bericht nicht als fertige Steuererklärung oder endgültig abzugsfähigen Verlust verwenden. Anteilsklassen wie GOOG/GOOGL sind konservative Prüffamilien, keine verbindliche Feststellung steuerlicher Gleichheit. Grundlage: IRS Publication 550: Wash Sales und Holding Period.

Stückzahlen und Kosten müssen endlich und nicht negativ sein; Verkaufsmengen und Kurse positiv. Pro Ticker eine Position, eindeutige Lot-IDs, und eine angegebene Positionsstückzahl muss zur Summe der Lots passen. Mehrere Depotauszugzeilen derselben Aktie vorab in einer Position mit mehreren Lots zusammenführen. Der gesamte Lot-Einstand darf null sein, zum Beispiel nach einer bestätigten Basisanpassung; fehlende Kosten nicht als null erfinden.

• Frist: langfristig (long term), wenn mehr als ein Jahr nach dem Kaufdatum verkauft wird, sonst kurzfristig (short term). report --lots zeigt das Datum, ab dem jedes Lot langfristig wird.
• Lot-Methoden: fifo (ältestes zuerst, das macht die Mehrheit der Broker standardmäßig), hifo (höchster Einstandswert zuerst) und specific (genannte Lots). Der Auftrag an den Broker trägt keine Lot-IDs: Um bestimmte Lots zu verkaufen, muss der Nutzer sie in der Steuer-Lot-Einstellung des Brokers selbst wählen, sonst nimmt der Broker seine Standardmethode.
• Wash Sale: Ein Verlust wird nicht anerkannt, soweit dieselbe oder eine im Wesentlichen gleiche Aktie innerhalb von 30 Tagen vor oder nach dem Verkauf gekauft wird. Das Tool prüft die anderen Lots, die noch gehalten werden, geplante Käufe in trader/orders.json und die Verlustverkäufe, die es protokolliert hat. Ein IRA-Konto, die Konten des Partners oder einen anderen Broker sieht es nicht, und die zählen auch. Sag das dazu. Verlust-Lots werden auch dann auf Konflikte geprüft, wenn andere Lots im selben Verkauf einen größeren Gewinn erzeugen. Der Gesamtgewinn darf einen einzelnen Wash-Sale-Verlust nicht verdecken. Der angegebene nicht anerkannte Betrag bleibt wegen der genannten Modellgrenzen eine Schätzung.

Schritte

1. Aktualisiere die Kurse, dann lots.py report --lots. Zeig Gewinne und Verluste je Aktie und welche Lots kurz- oder langfristig sind.
2. Vor jedem Verkauf (Rebalancing, ein Stopp, ein Sinneswandel) starte lots.py sell mit den geplanten Aktien und der Methode und zeig, was er realisieren würde.
3. Fürs Harvesting: lots.py harvest --min-loss 100 (und --min-pct, wenn der Nutzer eine Prozentschwelle will). Zeig für jeden Kandidaten den geschätzten Verlust, die Aufteilung in kurz- und langfristig, jeden Wash-Sale-Konflikt und den ersten Tag, an dem er wieder kaufen dürfte. Kandidaten mit Konflikt werden nicht vorgeschlagen.
4. Nur wenn der Nutzer Vorschläge will: harvest --write, dann /trader-skill-deutsch:trader-risiko, dann /trader-skill-deutsch:trader-broker, ein Ja pro Auftrag.
5. Nachdem ein Verkauf ausgeführt ist, aktualisiert lots.py sell ... --record die Lots und protokolliert das Ergebnis für das Jahr.

Beispiel: das Depot aus dem Reel

Das Kopier-Depot, gekauft am 2026-10-13 (AAPL 1,250 USD, AXP 1,119 USD, GOOGL 823 USD, KO 708 USD, BAC 600 USD), hat ein Lot pro Aktie, alle kurzfristig bis 2027-10-14. Fällt BAC später unter seinen Einstand von 600 USD, zeigt harvest --min-loss 25 das Lot BAC-1 mit seinem Verlust und "nicht wieder kaufen vor" einem Datum 31 Tage nach dem Verkauf. Hat der Nutzer zusätzlich einen BAC-Kauf in trader/orders.json geplant, meldet das Tool einen Wash Sale, statt den Verkauf vorzuschlagen.

Was er nie tut

Er reicht nichts ein, nennt nie einen Steuersatz oder eine Steuerrechnung, sagt nie, was der Nutzer schuldet, löst nie einen Auftrag aus und schlägt nie standardmäßig ein Harvesting mit erkanntem Wash-Sale-Konflikt vor. --include-wash ist eine ausdrückliche technische Ausnahme: nur auf klaren Nutzerwunsch verwenden, Konflikt und Modellgrenzen sichtbar beibehalten; keine steuerliche Freigabe daraus ableiten.

Sicherheit

• Keine Steuerberatung, und Bildung und Werkzeug, keine Anlageberatung. Sprich mit einer Steuerberatung. Die Regeln hier sind US-Steuerrecht; in Deutschland gilt die Abgeltungsteuer.
• Standardmäßig Paper Trading, also Spielgeld ("paper": true). Der Wechsel auf echtes Geld ist die eigene Entscheidung des Nutzers, in seiner eigenen Config.
• Dieses Skript löst keinen Auftrag aus. trader-broker bereitet ein Ticket vor, platziert selbst aber keine Order. Für einen separat verbundenen Broker sind Risikoprüfung, ausdrückliches Ja je Order und zusätzliche Tool-Genehmigung vorgesehen. Das sind Projektregeln und Berechtigungen, keine technisch unfehlbare Sperre für alle möglichen Ausführungswege. Kein Auftragswerkzeug auf "Always allow" setzen.
• Keine Optionen, kein Hebel (Margin), kein Leerverkauf (Short Selling), es sei denn, die Config erlaubt es und der Nutzer bestätigt es.
• Broker-Schlüssel liegen in Umgebungsvariablen oder in der Claude-Desktop- Config, nie im Chat.