Beispiele

Echte Beispiele für die Claude-Code-Skills des Plugins fim-portal, eines pro Skill: eine Anfrage, die fim-portal-Befehle, die der Skill ausgeführt hat, und Claudes Antwort.

Jedes Beispiel lief am 6. Oktober 2026 kurz nach Mitternacht gegen die Live-API, mit dem Stand von fim-portal, der als 0.3.0 erscheint (insgesamt 20 Anfragen). Die Daten ändern sich, Ihre Ergebnisse werden also abweichen; mit den gezeigten IDs und Schlüsseln können Sie die Anfragen selbst ausprobieren. Lange Listen sind gekürzt.

Zum Ausprobieren installieren Sie die CLI und das Plugin – siehe SKILLS.md (englisch).

Skills: fim-field-finder · fim-quality-audit · fim-schema-blueprint · fim-service-dossier

fim-field-finder

Gibt es ein freigegebenes, wiederverwendbares FIM-Auswahlfeld für die Staatsangehörigkeit mit hinterlegter Codeliste?

fim-portal --compact fields search --fts-query "Staatsangehörigkeit" --feldart select --freigabe-status 5 --freigabe-status 6 --is-latest --limit 20
fim-portal --compact fields search --name "Staatsangehörigkeit" --feldart select --is-latest --limit 50   # 45 Treffer
fim-portal --compact fields get baukasten F60000236 | jq '.code_list, (.schemas | length)'
fim-portal --compact fields get baukasten F00000001839 | jq '.code_list, (.schemas | length)'
fim-portal --compact fields get baukasten F00000000039 | jq '.code_list, (.schemas | length)'

Der Freigabe-Filter (5 silber, 6 gold) ließ 4 Felder übrig, zwei davon ohne Bezug zum Thema. Die Namenssuche nach Auswahlfeldern fand 45 aktuelle, fast alle XDF2-Kopien „in Bearbeitung”. Zwei verdienen einen Hinweis: Das zentrale Baukasten-Feld Staatsangehörigkeit (F00000000039) ist ein Entwurf, ebenso der XDF3-Nachfolger des Gold-Feldes, F60000000236 v1.7.0. Der maßgebliche Treffer ist daher das Gold-Feld aus dem Nummernkreis 60000, nicht das aus 00000. fields get listet jede Schemaversion, die ein Feld verwendet (148 für F60000236, etwa 1,2 MB); der Skill hat deshalb mit jq nur die Codeliste und diese Zahl gelesen, als Wiederverwendungssignal.

Wiederverwendbare Auswahlfelder für „Staatsangehörigkeit" (select · text, freigegeben, aktuell)

 1. F60000236  v1.4    Staatsangehörigkeit            baukasten · NK 60000 · select · text · Status 6 (gold) · XDF 2.0
    „Die Staatsangehörigkeit beschreibt den/die Staat(en), dem/denen ein Bürger juristisch zugehörig ist (Wahlrecht etc.)."
    Bezug: XOEV.Kernkomponente.NatuerlichePerson.staatsangehoerigkeit · Codeliste 12451 (Destatis
    Staatsangehörigkeit, Version 2023-02-24) · in 140 Schemata verwendet
 2. F00000001839  v1.0.0  Frühere Staatsangehörigkeit  baukasten · NK 00000 · select · text · Status 6 (gold) · XDF 3.0.0
    Codeliste 15830 (dieselbe Destatis-Liste, 2023-02-24) · in 7 Schemata verwendet · kein Bezug
 ⚠ F00000000039  v2.1.0  Staatsangehörigkeit          baukasten · NK 00000 · XDF 3.0.0 · Status 3 Entwurf
    zentrales XDF3-Feld mit derselben Definition, noch Entwurf, ältere Codeliste 15917 (2020-05-11), 8 Schemata
 ⚠ F60000000236  v1.7.0  Staatsangehörigkeit          NK 60000 · XDF 3.0.0 · Status 3 Entwurf · Codeliste 15926
    der XDF3-Nachfolger von Nr. 1, noch nicht freigegeben

 Weitere freigegebene Auswahlfelder betreffen nicht die Staatsangehörigkeit: F00000003381 Zweck des
 Aufenthalts (Schweiz), F00000003398 Status des Antragstellers gemäß Assoziationsabkommen EWG/Türkei.

Als Nächstes angeboten: fim-portal -o staatsangehoerigkeit.xml fields xdf baukasten F60000236 oder groups search, falls ein ganzer Personenblock besser passt.

fim-quality-audit

Wir möchten das FIM-Schema für die Daueraufenthaltsbescheinigung nachnutzen. Bitte vorher eine Qualitätsprüfung.

fim-portal --compact schemas search --fts-query "Daueraufenthaltsbescheinigung" --is-latest --limit 10
fim-portal --compact schemas versions S00000000239
fim-portal --compact schemas quality-report S00000000239 latest
fim-portal --compact schemas get S00000000239                      # um die gemeldeten IDs zu benennen

Drei Schemata passten. Das XDF3-Schema S00000000239 ist das einzige freigegebene Antragsformular für die Bescheinigung; die anderen beiden sind die XDF2-Daueraufenthaltskarte (S00000235) und ein XDF2-Entwurf (S00000239). Es gibt nur eine Version (1.1.0). Der Bericht enthält nur IDs, deshalb hat der Skill sie mit dem Feld- und Gruppenkatalog des Schemas verknüpft, um Namen anzuzeigen.

Qualitätsprüfung: Antrag auf Ausstellung einer Daueraufenthaltsbescheinigung
                  (S00000000239 v1.1.0, XDF3, fachlich freigegeben (gold))
  14 Befunde: 0 Fehler, 14 Warnungen → nachnutzbar mit Hinweisen
  (59 Felder, 19 Gruppen; 13 Feld-Befunde, 1 Gruppen-Befund)

  Häufigste Probleme:
   • 9× Warnung 1101  leerer Bezug bei harmonisiertem Feld („Leerer Bezug bei Feld … mit Typ `harmonisiert`")
        F00000001839 Frühere Staatsangehörigkeit, F60000000231/232/233 Tag/Monat/Jahr,
        F60000000263 Abfrage Anschrift Inland oder Ausland, F60000000350 Betreuungsurkunde … (+3 weitere)
   • 3× Warnung 1103  kein Wertebereich („Kein Wertebereich … angegeben")
        F00000003244 Einreisedatum, F60000000048 Anfang, F60000000049 Ende
   • 1× Warnung 1102  keine Mindest-/Höchstlänge: F00000003247 Grund (Sonstiges)
   • 1× Warnung 1106  Gruppe mit nur einem Unterelement: G60000000092 Anschriftzone
  Regeln: 22 geprüft, alle ohne Befund.   Schema-Ebene: ohne Befund.

Als Nächstes angeboten: fim-portal fields get baukasten F00000003244, um zu sehen, warum das Einreisedatum keinen Wertebereich hat. Da es nur diese Version gibt, fehlt eine Alternative zum Vergleich.

fim-schema-blueprint

Was fragt das FIM-Formular zur Anmeldung eines Hundes zur Hundesteuer ab?

fim-portal --compact schemas search --fts-query "Hundesteuer" --is-latest --limit 10
fim-portal --compact schemas get S05000039

Die Suche fand 7 Schemata rund um Hunde. S05000039 Anmeldung zur Hundesteuer ist die Anmeldung (gold). In dieser Antwort enthält der children[]-Baum nur die 4 obersten Knoten ohne Verschachtelung. Deshalb hat der Skill die eigenen children jeder Gruppe in datenfeldgruppen[] durchlaufen, um die Gliederung aufzubauen.

Schema: Anmeldung zur Hundesteuer  (S05000039 v1.1, XDF2, fachlich freigegeben (gold))
  Kein Steckbrief verknüpft · 29 Felder in 15 Gruppen · 1 Regel (R05000237)
  Rechtsgrundlage: Hundesteuergesetze bzw. Kommunalabgabengesetze der Länder (kommunale Steuer)
  ⚠ Im Gold-Schema sind 28 Felder und alle 15 Gruppen „in Bearbeitung"; Telefon (F60000240) ist „inaktiv"

• Einwilligungserklärungstext Verarbeitung personenbezogener Daten (F05000698)  select · text [→ Codeliste 777]  1:1
▸ Antragstellende Person (G05000276)  1:1
   ▸ Persönliche Angaben (Familienname & Vorname) (G05000366): Familienname, Vorname   input · text  1:1
   ▸ Anschrift Inland Straßenanschrift (G05000527): Straße, Hausnummer, Hausnummerzusatz 0:1,
     Postleitzahl, Ort, Anschrift Zusatzangaben 0:1                         input · text
   ▸ Kommunikation (Telefon/E-Mail) (G05000528): Telefon (F60000240) 0:1 ⚠ inaktiv, E-Mail (F05001109) 0:1
▸ Anzahl (Hund) (G05000434)  1:1
   • Weiterleitung der Daten (F05000728)          select · text [→ Codeliste 1443]  1:1
   • Anzahl Hunde (Antragsstellung) (F05000977)   input · num_int  1:1
   • Anzahl gehaltener Hunde (F05000791)          input · num      1:1
▸ Angaben (Hund Steueranmeldung) (G05000442)  1:1
   ▸ Steuer-ID (Hund) (G05000436): Akten- / Kassenzeichen, Name des Hundes,
     Mikrochipkennzeichnung des Hundes                                      input · text  je 0:1
   ▸ Angaben zum Hund (Mittel) (G05000319): Geburtsdatum des Hundes (date, 0:1), Hunderasse (text, 1:1)
   ▸ Abweichende Anschrift des Hundes (G05000337): Abweichender Haltungsort (bool, 1:1)
     + optionale Anschriftsgruppe G05000529 (0:1, eigene 05000-Kopien von Straße/Ort)
   ▸ Grund für die Ermäßigung oder Befreiung von der Hundesteuer (G05000340)  1:1
      • Auswahl des Grundes … (F05000802)          select · text [→ Codeliste 1844]  1:1
      • Weiterer Grund … (F05000803)               input · text  0:1
      • Unterlagen … (F05000804)                   input · file  1:1

Als Nächstes angeboten: fim-portal -o hundesteuer.xml schemas xdf S05000039 1.1 oder eine beliebige Gruppe bis auf Feldebene aufklappen.

fim-service-dossier

Alles zur FIM-Leistung, mit der Deutsche mit Wohnsitz im Ausland einen Personalausweis beantragen.

fim-portal --compact service-profiles search --fts-query "Personalausweis" --sprache Deutsch --limit 10   # 54 Treffer
fim-portal --compact service-profiles search --fts-query "Personalausweis Wohnsitz im Ausland" --sprache Deutsch --limit 10
fim-portal --compact service-profiles get 99008001012011
fim-portal --compact service-texts search --leistungsschluessel 99008001012011
fim-portal --compact service-texts get B100019 102241587 pvog

Die breite Suche fand 54 Leistungen, die für Menschen mit Wohnsitz im Ausland stand nicht auf der ersten Seite. Deshalb hat der Skill die Suche eingeengt: 2 Treffer, 99008001012011 zuerst. Bevor er einen Text abrief, hat er nachgesehen, zu welcher Quelle jeder gehört: Der Bundestext liegt unter pvog, nicht unter leika.

Personalausweis für Deutsche mit Wohnsitz im Ausland   (Schlüssel 99008001012011)
  Bezeichnung:  „Personalausweis für deutsche Staatsangehörige mit ständigem Wohnsitz
                beziehungsweise gewöhnlichem Aufenthalt im Ausland beantragen"
  Für:          Bürgerinnen und Bürger (001)   Typ: lovd   Status: 6 (fachlich freigegeben, gold), geändert 2026-04-20
  OZG:          Personalausweis (#10119), Querschnittsleistungen     SDG: 1010100
  Rechtsgrundlagen: PAuswG §§ 1(4) Nr. 2, 5(2) Nr. 9, 7(2), 8(2)(4), 23(4), 35; KonsG § 2;
                PAuswVwV G.5.2.1/G.5.2.2; Personalausweis- und eID-Karten-Gebührenverordnung
  Prozess:      keiner verknüpft   Ersetzungen: keine
  Regionale Texte: 10 Redaktionen
    • Bund     B100019 (pvog) – maßgeblich
    • Länder   L100002, L100008, L100010, L100012, L100038, L100039, L100040, L100041 (landesredaktion)
    • Berlin   L100108 (pvog) – gilt auch für in Berlin nicht gemeldete Personen und Touristen
  Kurzfassung (Bund): Antrag persönlich bei der deutschen Auslandsvertretung, die für den
    Wohnort zuständig ist; aus wichtigem Grund auch in jedem Bürgeramt in Deutschland – den
    Grund vorher telefonisch mit dem Amt klären.
  → jeden Text abrufen mit: service-texts get <redaktion_id> <leistung_id> <source>

Als Nächstes angeboten: das PDF für Bürgerinnen und Bürger (fim-portal -o leistung.pdf service-profiles pdf 99008001012011 de-DE) oder der eigene Text eines Landes.

Quelle auf GitHub ansehen →