goromal/agent-skills

Integriere, sortiere, organisiere oder leite ITNS-Notizen („Integrate These Notes Somewhere“) von einer benannten Notion-Seite in passende Unterseiten weiter. Verwende dies, wenn der Benutzer ITNS erwähnt, die Verarbeitung eines Notion-Notiz-Repositories anfordert oder eine Seite nennt, deren lose Notizen abgelegt werden sollen. Löse Seitennamen über ~/configs/goromail-categories.csv auf, verschiebe offensichtliche Notizen automatisch und fordere für jede mehrdeutige Platzierung oder neue Unterseite die Entscheidung des Benutzers an.

Was ist agent-skills?

Diese Fertigkeit für KI-Agenten (wie Claude Code, Cursor oder Codex) ermöglicht die automatisierte Verarbeitung von ITNS-Notizen („Integrate These Notes Somewhere“) aus einer genannten Notion-Quellseite. Sie liest eine CSV-Konfigurationsdatei (~/configs/goromail-categories.csv), um die Quellseite anhand ihres Namens eindeutig zu identifizieren, und untersucht dann alle Blöcke und Unterseiten der Seite. Die Fertigkeit analysiert den Inhalt jeder Note, erkennt semantisch passende Zielunterseiten und entscheidet selbstständig oder fragt den Benutzer: Eine automatische Verschiebung erfolgt nur, wenn genau eine Unterseite einen starken semantischen Treffer darstellt, die Notizgrenzen klar sind und keine Umformulierung, Aufteilung oder neue Kategorie erforderlich ist. In allen mehrdeutigen Fällen wird dem Benutzer eine Vorschau mit Empfehlung präsentiert, der die endgültige Entscheidung trifft. Die Fertigkeit unterstützt den Notion MCP Server für alle Verschiebeoperationen und führt nach jedem Batch Verifizierungsschritte durch, um sicherzustellen, dass keine Blöcke verloren gehen oder dupliziert werden. Sie eignet sich ideal für Entwickler, die ihre Notion-Wissensdatenbank regelmäßig aufräumen müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/itns-notes

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ITNS-Notizen verarbeiten

Verwende den installierten Notion-MCP-Server. Bewahre die Formulierung, Formatierung, Links, Daten, Prioritätsmarkierungen, Blocktypen, Reihenfolge und verschachtelten Kinder jeder Note. Fasse nichts zusammen, schreibe es um, teile es auf, führe es zusammen, dedupliziere oder lösche Inhalte, es sei denn, der Benutzer fordert dies ausdrücklich.

Quellseite ermitteln

  1. Vergleiche den vom Benutzer angegebenen Seitennamen exakt und ohne Berücksichtigung der Groß-/Kleinschreibung mit der ersten Spalte von ~/configs/goromail-categories.csv.
  2. Verwende die entsprechende Notion-Seiten-ID aus der zweiten Spalte.
  3. Stoppe und frage nach, wenn es keine exakte Übereinstimmung oder mehr als eine exakte Übereinstimmung gibt. Errate niemals eine ID anhand eines ähnlichen Namens.

Notizen und Ziele ermitteln

  1. Rufe notion_list_subpages für die Quellseite auf, um mögliche Zielseiten zu sammeln.
  2. Rufe notion_list_blocks mit recursive: true für die Quellseite auf. Behandle einen Elternblock und alle Nachkommen als einen unteilbaren Notizbaum.
  3. Behandle benachbarte Absätze, Listenelemente, Codeblöcke und andere Textblöcke auf oberster Ebene als eine zusammengesetzte Note, wenn ihr Inhalt eindeutig einen zusammenhängenden Gedanken bildet. Wenn die Grenze unsicher ist, klassifiziere sie als mehrdeutig und frage den Benutzer.
  4. Schließe Überschriften, Unterseiten-Blöcke, Seitenverweis-Links und andere Navigations- oder Strukturblöcke aus. Wenn eine Überschrift „Repository“ vorhanden ist, verwende den losen Inhalt danach als Quellnotizregion. Wenn keine zuverlässige Quellnotizgrenze existiert, frage, bevor du etwas verschiebst.
  5. Untersuche relevante Zielinhalte mit rekursiver Blockauflistung. Klassifiziere sowohl anhand des Zieltitels als auch des vorhandenen Themengebiets, nicht nur des Titels.
  6. Bei undurchsichtigen Links oder vagen Bezeichnungen untersuche das verlinkte Material, wenn Zugriff besteht. Frage lieber nach, als zu interpretieren, wenn das Thema unklar bleibt.

Automatisch entscheiden oder nachfragen

Verschiebe eine Note nur dann automatisch, wenn alle folgenden Punkte zutreffen:

  • Es gibt genau eine vorhandene Unterseite, die eine starke semantische Übereinstimmung darstellt;
  • Die vollständige Note und ihre Grenzen sind bekannt;
  • Die Verschiebung erfordert keine Umformulierung, Aufteilung, Zusammenführung oder Kategorieerfindung.

Behandle jeden anderen Fall als mehrdeutig. Zeige die vollständige Note oder eine originalgetreue kompakte Vorschau, die plausiblen Ziele und eine Empfehlung mit kurzer Begründung an. Warte auf die Entscheidung des Benutzers, bevor du diese Note schreibst. Frage immer, bevor du eine neue Unterseite erstellst oder benennst.

Fahre mit der Verarbeitung unabhängiger offensichtlicher Notizen fort, während mehrdeutige Notizen auf eine Entscheidung warten. Lasse nicht zu, dass eine offensichtliche Platzierung eine verwandte mehrdeutige Platzierung stillschweigend beeinflusst.

Verschiebungen ausführen und überprüfen

  • Verschiebe einen Notizbaum auf oberster Ebene mit notion_move_block; seine Nachkommen werden mitverschoben.
  • Verschiebe eine zusammengesetzte Note aus benachbarten Blöcken auf oberster Ebene mit notion_move_blocks. Übergib die Block-IDs einmal in ihrer ursprünglichen Reihenfolge an ein Ziel.
  • Erstelle eine vom Benutzer genehmigte Kategorie mit notion_create_subpage und verschiebe dann nur die dafür genehmigten Notizen.
  • Simuliere niemals eine Verschiebung durch verlustbehaftetes Anhängen von Text gefolgt von Löschung.
  • Liste nach jedem Batch die Quelle und das Ziel erneut auf. Überprüfe, dass jeder Quellblock fehlt, jeder Zielblock in der richtigen Reihenfolge vorhanden ist, die Kinderanzahlen übereinstimmen und Blocktypen und Text erhalten bleiben.
  • Wenn ein Vorgang teilweise fehlschlägt, stoppe weitere Schreibvorgänge, überprüfe beide Seiten und melde die genauen kopierten, archivierten, verbleibenden oder duplizierten Blöcke, bevor du eine Reparatur versuchst.
  • Wenn rekursive Auflistung oder geordnete Batch-Verschiebungen nicht verfügbar sind, stoppe und melde, dass der Notion-MCP-Server bereitgestellt oder aktualisiert werden muss, bevor zusammengesetzte Notizen sicher verarbeitet werden können.

Ende mit einer präzisen Aufzeichnung der automatischen Verschiebungen, der vom Benutzer genehmigten Verschiebungen, der erstellten Seiten, der zurückgestellten Mehrdeutigkeiten und der Überprüfungsergebnisse.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills