Daten für Chatbots und Agenten

Bonner Haushalt mit KI-Assistenten nutzen

KI-Assistenten können die Zahlen dieser Website direkt abrufen. Dann antworten sie mit Jahr, Status und Quelle, statt Zahlen aus dem Gedächtnis zu raten. Für einen einzelnen Chat hängen Sie die Dateien an. Agenten wie Claude Code lernen den Zugang einmal als Skill und nutzen ihn danach von selbst.

Anmeldung erforderlich

Die Website ist zurzeit passwortgeschützt. Das gilt auch für die Daten, die KI-Assistenten abrufen: API, llms.txt und Skill. Ihr Browser ist bereits angemeldet, ein Agent braucht die Zugangsdaten selbst.

Skill, Installationstext und Befehle auf dieser Seite enthalten die Anmeldung bereits. Mit curl lautet sie -u secret:password. Ohne Anmeldung antwortet der Server mit „401 Unauthorized“. Bitte geben Sie die Zugangsdaten nicht öffentlich weiter.

Im Chat: Dateien anhängen

Chatbots wie ChatGPT, Claude, Gemini oder Perplexity können sich beim Lesen von Webseiten nicht anmelden. Solange die Website passwortgeschützt ist, laden Sie die Daten deshalb selbst herunter und hängen sie an den Chat an: llms.txt erklärt Regeln und Aufbau, die Zahlen stehen in den JSON-Dateien, zum Beispiel 1-05.json für Soziale Leistungen. Welche Datei zu welchem Thema gehört, steht in aufgaben.json und kennzahlen.json. Kopieren Sie dann den folgenden Text in den Chat und ersetzen Sie die Frage durch Ihre eigene.

Lies die angehängten Dateien llms.txt und 1-05.json und beantworte nur mit diesen Daten: Was wurde 2025 in Bonn für Sozialhilfe ausgegeben? Nenne zu jeder Zahl Jahr, Status und Quelle.

Als Skill: dauerhaft für Agenten

Ein Skill ist eine Textdatei namens SKILL.md, die ein Agent dauerhaft speichert. Oben steht eine kurze Beschreibung. Daran erkennt der Agent, wann der Skill passt, und liest erst dann den Rest. Das offene Format stammt von agentskills.io und wird von mehreren Agenten unterstützt.

Unser Skill enthält:

Er enthält keine Beträge und keine Skripte. Die Zahlen lädt der Agent bei jeder Frage neu, eine installierte Kopie veraltet also nicht. Kommen neue Jahre hinzu, findet der Agent sie in der API.

Skill installieren

Claude Code: Agent installiert selbst

Kopieren Sie diesen Text in Claude Code oder einen anderen Agenten mit Zugriff auf Ihre Dateien. Er enthält die Anmeldung. Der Agent zeigt vor dem Speichern, was die Datei enthält.

Installiere den Skill von https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md. Die Website ist passwortgeschützt (HTTP Basic Auth, Benutzername secret, Passwort password), lade die Datei also mit Anmeldung (bei curl mit der Option -u). Speichere sie unverändert als was-kostet-bonn/SKILL.md in deinem Ordner für Skills (bei Claude Code ~/.claude/skills/). Zeige mir vorher kurz, was sie enthält.

Claude Code: von Hand im Terminal

Für alle Projekte im Ordner ~/.claude/skills/, nur für ein Projekt in .claude/skills/ im Projektordner:

mkdir -p ~/.claude/skills/was-kostet-bonn && curl -fsS -u secret:password -o ~/.claude/skills/was-kostet-bonn/SKILL.md https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md

Claude Code erkennt den Skill in der nächsten Sitzung. Mit /skills sehen Sie, ob er geladen ist.

Claude-App und claude.ai

  1. SKILL.md herunterladen.
  2. Einen Ordner was-kostet-bonn anlegen, die Datei hineinlegen und den Ordner als ZIP-Datei packen.
  3. In den Einstellungen unter „Fähigkeiten“ bei „Skills“ die ZIP-Datei hochladen. Die Bezeichnungen können sich je nach Version unterscheiden.

Die Zahlen lädt Claude dort per Codeausführung mit der Anmeldung aus dem Skill. Das klappt nur, wenn die Codeausführung ins Internet darf und die Domain www.was-kostet-bonn.de erreichen kann. Sonst bleibt der Weg über angehängte Dateien wie im Chat.

Andere Agenten

Codex, Cursor, Gemini CLI und weitere Agenten lesen dasselbe Format aus einem eigenen Skill-Ordner. Die Datei bleibt gleich: Ordner was-kostet-bonn, darin SKILL.md. Welcher Ordner gilt, steht in der Anleitung des jeweiligen Agenten. Einfacher ist der Installationstext oben: Der Agent kennt seinen Ordner selbst.

Beispiele: So läuft ein Gespräch

Gekürzte Gespräche mit einem Agenten, der den Skill installiert hat. Die Zahlen stammen aus den aktuellen Daten dieser Website. Die grauen Zeilen zeigen, welche Dateien der Agent abruft.

Skill installieren (Claude Code)
  1. Sie

    Installiere den Skill von https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md. Die Website ist passwortgeschützt (HTTP Basic Auth, Benutzername secret, Passwort password), lade die Datei also mit Anmeldung (bei curl mit der Option -u). Speichere sie unverändert als was-kostet-bonn/SKILL.md in deinem Ordner für Skills (bei Claude Code ~/.claude/skills/). Zeige mir vorher kurz, was sie enthält.

  2. Agent

    Lädt https://www.was-kostet-bonn.de/skills/was-kostet-bonn/SKILL.md mit Anmeldung

    Die Datei ist eine reine Textanleitung ohne Skripte und ohne Beträge. Sie enthält die Zugangsdaten für die passwortgeschützte API, Regeln (Jahr, Status und Quelle immer nennen, Plan und Ist nie addieren), die Adresse der API und einen Katalog aller Aufgaben und Kennzahlen. Soll ich sie unter ~/.claude/skills/was-kostet-bonn/SKILL.md speichern?

  3. Sie

    Ja.

  4. Agent

    Speichert ~/.claude/skills/was-kostet-bonn/SKILL.md

    Gespeichert. Bei Fragen zum Bonner Haushalt nutze ich den Skill ab jetzt automatisch.

Frage nach den Schulden, mit Nachfrage
  1. Sie

    Wie hoch sind die Schulden der Stadt Bonn?

  2. Agent

    Lädt https://www.was-kostet-bonn.de/api/v1/kennzahlen/kredite-core-debt.json

    Die Kreditschulden des Kernhaushalts lagen am 31.12.2024 bei 2,24 Mrd. € (Ist). Für 2025 nennt der noch nicht festgestellte Jahresabschluss 2,52 Mrd. € (Entwurf). Dieser Wert ist vorläufig. Enthalten sind Investitions- und Liquiditätskredite der Stadt selbst, nicht die Schulden städtischer Unternehmen wie der Stadtwerke.

    Quellen: Prüfbericht Jahresabschluss 2024 (Ist 2024) · Jahresabschluss 2025 Entwurf Teil 1 (Entwurf 2025)

  3. Sie

    Wie viel ist das pro Einwohner?

  4. Agent

    Lädt https://www.was-kostet-bonn.de/api/v1/kennzahlen/kredite-core-debt-per-capita.json

    Am 31.12.2024 waren es 6.671 € je Einwohnerin und Einwohner (Ist). Für 2025 liegt nur der Entwurf der Gesamtschulden vor, noch kein Pro-Kopf-Wert.

    Quellen: Prüfbericht Jahresabschluss 2024 (Ist 2024)

Der Skill verhindert falsche Summen
  1. Sie

    Rechne die Ausgaben aus dem Plan 2026 und dem Ist 2024 zusammen.

  2. Agent

    Das mache ich nicht: Plan 2026 ist ein beschlossener Ansatz, Ist 2024 sind tatsächlich gebuchte Werte. Eine Summe aus beiden hätte keine Bedeutung. Ich kann die beiden Jahre nebeneinanderstellen oder für 2026 Plan und Prognose vergleichen.

KI-Assistenten können sich trotzdem irren. Prüfen Sie wichtige Zahlen über die Quelle, die zu jedem Wert angegeben ist.

Dateien und Schnittstelle

Tabellen zum Herunterladen und alle Originalquellen stehen unter Daten und Quellen.