From 9f932abd2ee2d720f312d5c0f4560e0c1e639523 Mon Sep 17 00:00:00 2001
From: SysAdmin Agent <sysadmin@vhtv-stiftung.de>
Date: Sun, 5 Apr 2026 21:49:12 +0000
Subject: [PATCH] Add Paperclip skill definition for GrampsWeb MCP server
 (STI-104)

SKILL.md enables Paperclip agents to discover and use the GrampsWeb
MCP server for genealogy data access.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
---
 app/gramps_mcp_server/SKILL.md | 61 ++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 app/gramps_mcp_server/SKILL.md

diff --git a/app/gramps_mcp_server/SKILL.md b/app/gramps_mcp_server/SKILL.md
new file mode 100644
index 0000000..74a74ca
--- /dev/null
+++ b/app/gramps_mcp_server/SKILL.md
@@ -0,0 +1,61 @@
+---
+name: grampsweb
+description: >
+  GrampsWeb Ahnenforschung MCP Server – Zugriff auf Personen, Familien,
+  Ereignisse, Orte, Quellen, Medien und Notizen des Stammbaums der Stiftung.
+  Verwende diesen Skill für alle genealogischen Recherchen.
+mcp:
+  command: python
+  args:
+    - "-m"
+    - "gramps_mcp_server"
+  cwd: ./app
+  env:
+    GRAMPS_URL: "${GRAMPS_URL:-http://grampsweb:5000}"
+    GRAMPS_USERNAME: "${GRAMPS_USERNAME}"
+    GRAMPS_PASSWORD: "${GRAMPS_PASSWORD}"
+---
+
+# GrampsWeb Ahnenforschung
+
+MCP-Server für die GrampsWeb-Genealogie-Datenbank der Stiftung.
+
+## Verfügbare Tools (Phase 1 – Lesen)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `person_suchen` | Personen im Stammbaum nach Name suchen |
+| `person_details` | Vollständige Details einer Person (Events, Familien, Medien) |
+| `familie_details` | Familienverbindungen (Eltern, Kinder, Ereignisse) |
+| `ereignis_details` | Ereignis-Details (Geburt, Tod, Heirat, etc.) |
+| `ort_suchen` | Orte im Stammbaum suchen |
+| `ort_details` | Orts-Details |
+| `quelle_suchen` | Quellen (Kirchenbücher, Urkunden) suchen |
+| `quelle_details` | Quellen-Details mit Zitierungen |
+| `stammbaum_export` | GEDCOM oder Gramps-XML Export |
+| `stammbaum_info` | Metadaten und Statistiken des Stammbaums |
+| `medien_liste` | Medienobjekte (Fotos, Scans) auflisten |
+| `notiz_details` | Notiz-Inhalt lesen |
+
+## Nutzung
+
+### Personen suchen
+```
+person_suchen(suchbegriff="Müller", pro_seite=10)
+```
+
+### Person-Details abrufen
+```
+person_details(handle="abc123def")
+```
+
+### Stammbaum-Statistiken
+```
+stammbaum_info()
+```
+
+## Voraussetzungen
+
+- GrampsWeb muss erreichbar sein (intern: `http://grampsweb:5000`)
+- Gültige `GRAMPS_USERNAME` und `GRAMPS_PASSWORD` Umgebungsvariablen
+- Python-Paket `mcp>=1.0.0` und `requests` müssen installiert sein