diff --git a/.claude/skills/finanz-api/SKILL.md b/.claude/skills/finanz-api/SKILL.md
index 1762f87..41e4906 100644
--- a/.claude/skills/finanz-api/SKILL.md
+++ b/.claude/skills/finanz-api/SKILL.md
@@ -127,10 +127,18 @@ curl -s -H "Authorization: Bearer $KEY" \
 `GET`/`POST` (`name`, `description`, `include_recurring`, `include_planned`),
 `PATCH`/`DELETE /{id}`. Namen mit Präfix `System-` sind reserviert (422).
 Kredit zuordnen: `POST`/`DELETE
-/{id}/loans/{loan_id}`. Modifikator hinzufügen: `POST /{id}/modifiers` mit
+/{id}/loans/{loan_id}`. Eintrag (Modifikator) hinzufügen: `POST /{id}/modifiers` mit
 `target_type` (`category`|`recurring`), `target_id`, `kind`
-(`percent`|`absolute`|`remove`), `value`; löschen über `DELETE
-/{id}/modifiers/{mod_id}`.
+(`percent`|`absolute` = Kürzung in €|`set` = neuer Betrag mit Vorzeichen, nur
+`recurring`|`remove`|`ende`), `value`, optional `start_date`/`end_date`
+(Gültig ab/bis, inklusiv; bei `ende` ist `end_date` Pflicht und das
+Enddatum); ändern per `PATCH` (voller Body), löschen über `DELETE
+/{id}/modifiers/{mod_id}`. Szenario-eigene Einmalzahlungen: `/{id}/planned`
+(`name`, `amount`, `due`, optional `category_id`). Szenario-eigene
+wiederkehrende Zahlungen: `/{id}/recurring` (`name`, `amount`, `rhythm`,
+`due_day`, optional `start_date`, `end_date`, `category_id`) mit
+`GET`/`POST`/`PATCH`/`DELETE`; zählen immer, unabhängig von
+`include_recurring`.
 
 ```bash
 curl -s -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
diff --git a/.claude/skills/finanzberatung/SKILL.md b/.claude/skills/finanzberatung/SKILL.md
index 00dc655..1b33b9f 100644
--- a/.claude/skills/finanzberatung/SKILL.md
+++ b/.claude/skills/finanzberatung/SKILL.md
@@ -36,6 +36,9 @@ Beratung erfolgt datengetrieben über das Finanzberatungs-Tool (Skill
 - Kürzungspotenzial: Modifikatoren je Kategorie oder wiederkehrendem Posten
   anlegen (`POST /api/scenarios/{id}/modifiers`, `target_type`
   `category`|`recurring`, `kind` `percent`|`absolute`|`remove`).
+  Änderungen ab einem Stichtag (z. B. Rate halbiert ab Oktober) als Eintrag
+  mit `start_date` abbilden, nicht als Ende + neuer Posten; neue laufende
+  Zahlungen nur für eine Variante über `/api/scenarios/{id}/recurring`.
 - Für jede Fragestellung ein eigenes Szenario (Kopie der Idee, nicht das
   Basis-Szenario verändern), damit Varianten unabhängig vergleichbar bleiben.