CommunityBildgithub.com

Handschrift-Seitenkonvertierung

Konvertiert fotografierte handschriftliche Dokumente (Aufgaben, Notizbuchseiten) in ein sauberes, vollständiges Dokument in einer einzigen ausgewählten Referenzhandschrift – mit übereinstimmendem Schriftstil, Strichstärke, Tintenfarbe und Papierton, Seite für Seite, mit überprüfter Textgenauigkeit.

Was ist Handschrift-Seitenkonvertierung?

Der Skill "Handschrift-Seitenkonvertierung" ermöglicht es KI-Agenten (wie Claude Code, Cursor, Codex), eine Reihe von fotografierten handschriftlichen Seiten konsistent in eine einzige Zielhandschrift umzuschreiben. Die Zielhandschrift wird durch eine einzige genehmigte Referenzseite (die "Standardseite") festgelegt, die für alle folgenden Seiten als Vorlage für Buchstabenformen, Strichstärke, Tintenfarbe und Papierton dient. Der Skill verwendet einen strengen, messbasierten Workflow, der aus Transkription, frischer Bilderzeugung (nicht Fotokopie), pixelgenauer Größen- und Strichstärkenkorrektur sowie Farbangleichung besteht, um eine einheitliche Ausgabe zu gewährleisten. Er unterstützt Bildgeneratoren mit Referenzbild-Eingabe, Bildbetrachter mit Zoomfunktion und Skript-Laufzeiten mit Bildbibliotheken (z. B. Python + PIL/numpy) für Messung und Compositing. Dieser Skill ist entscheidend für Anwendungsfälle wie das Klonen einer Handschrift über viele Seiten, das Erstellen einheitlicher PDFs aus eingescannten Notizen oder das Neuschreiben von Dokumenten in einer bestimmten Hand, ohne dass der generierte Text wie eine Schriftart aussieht oder Fehler aus der Quelle verliert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AshfanAnsari/handwriting-page-conversion-skill/tree/HEAD

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Handschrift-Seitenkonvertierung?

Jede Seite eines handschriftlichen Dokuments in eine Zielhandschrift umschreiben. Die Zielhandschrift wird durch EINE genehmigte Referenzseite (die "Standardseite") definiert. Jede andere Seite muss in vier unabhängigen Achsen übereinstimmen: Text, Handschriftidentität, Strichstärke/-größe und Farbe (Tinte + Papier). Eine Seite ist erst fertig, wenn alle vier Achsen bestehen.

Sie benötigen: einen Bildgenerator, der ein Referenzbild akzeptiert, einen Bildbetrachter mit Zoomfunktion und eine Skript-Laufzeit mit einer Bildbibliothek (z. B. Python + PIL/numpy) für Messung, Compositing und Bewertung.

Kernregeln (aus Erfahrung gelernt – nicht überspringen)

  1. Fügen Sie der Generator das Quellseitenfoto NIEMALS als Stil-/Layoutreferenz zu. Es würde die Quelle fotokopieren – die ursprüngliche Handschrift kommt unverändert zurück und es sieht aus wie konvertiert. Jede Seite frisch generieren aus: dem Standardseiten-Bild + einer exakten Transkription des Textes der Quellseite. Nichts weiter.
  2. Bewahren Sie die eigenen Schreibweisen und Fehler des Schreibers. Transkribieren Sie genau das, was die Quelle sagt, einschließlich Rechtschreibfehler ("Equillibrium", "Singal", "Koexistenz"). Die Quellseite ist die Autorität für den Inhalt, sogar gegenüber Referenzbüchern und Ihrem eigenen Wissen. Zahlen, Tabellenwerte und Formeln ziffernweise gegen die Quelle bei Zoom überprüfen.
  3. Überprüfen Sie die vier Achsen separat. Eine Seite kann Text bestehen und Handschrift nicht bestehen (zu ordentlich, rund, fett, schriftartähnlich – der Standard des Generators). Nur-Text-Überprüfung besteht trivialerweise auf einer fotokopierten Seite, was dazu führt, dass schlechte Versionen ausgeliefert werden.
  4. Arbeiten Sie Seite für Seite. Bauen Sie eine Seite auf, präsentieren Sie sie, holen Sie das Urteil des Benutzers ein (oder sein "Baue alle, ich bewerte später"), bevor Sie etwas zusammenstellen. Korrigieren Sie nur die Seiten, die der Benutzer markiert – wechseln Sie niemals stillschweigend zusätzliche Seiten aus.
  5. Zeichnen Sie keine Grafiken, Diagramme oder Tabellen neu, wenn Sie es vermeiden können. Neuanfertigungen zerstören die Geometrie (Kurven, die sich nicht treffen, doppelte Achsenstriche, falsche Endpunkte). Übernehmen Sie gedruckte/diagrammierte Seiten unverändert. Bei einem kleinen Beschriftungsfehler auf einer ansonsten korrekten Zeichnung Pixel patchen: Löschen Sie mit einem Spendepatch von überprüft leerem Papier von derselben Seite, zeichnen Sie das abgenickte Segment in der gemessenen Tintenfarbe neu. Lokalisieren Sie Tinte anhand von Dunkelpixel-Zeilen-/Spaltenprofilen – schätzen Sie Koordinaten niemals anhand einer verkleinerten Vorschau ab.

Arbeitsablauf

1. Standard festlegen

  • Wählen Sie die beste Seite (oder generieren Sie eine Demoseite und lassen Sie sie genehmigen). Diese Seite legt fest: Buchstabenformen, mittlere Zeilenhöhe (messen, z. B. ~40 px bei Arbeitsauflösung), Strichstärke, Tintenfarbe (messen, z. B. dunkelblau-schwarz RGB ≈ [58,58,65]) und Papierton (z. B. RGB ≈ [208,206,209]).
  • Jede spätere Seite wird gegen diese Seite bei angepasstem Maßstab beurteilt – Strichstärkenvergleiche bei unterschiedlichen Zoomstufen lügen.

2. Transkribieren

  • Lesen Sie jede Quellseite in Originalgröße, dann zoomlesen Sie jedes verdächtige Wort. Schreiben Sie die exakte Transkription, unter Beibehaltung von Rechtschreibung, Zeichensetzung, Unterstreichungen, Boxen, Überschriften und leeren Bereichen (wenn das Original die halbe Seite leer lässt, tut es die Neuschreibung auch).
  • Listen Sie die "Fallenwörter" der Seite (lange/ungewöhnliche Wörter, Werte, Formeln) explizit auf – diese erhalten buchstabierte Schutzleisten im Generierungs-Prompt und eine persönliche Zoom-Kontrolle danach.

3. Frisch generieren

  • Prompt: das Standardseiten-Bild als EINZIGE Bildreferenz + die exakte Transkription + eine dünn-primäre Stilangabe: "feiner Kugelschreiber, leichter Druck, dünne unregelmäßige Striche, dunkelblau-schwarze Tinte, niemals dick / fett / schwer / ordentlich". Nur-Text-Prompts driften in die ordentliche Standard-Handschrift des Modells ab – das Referenzbild muss im Aufruf enthalten sein.
  • Wenn Ihr Generator das Fortsetzen/Wiederaufnehmen aus dem Zustand einer vorherigen Generierung unterstützt, ergibt das Wiederaufnehmen der Generierung der Standardseite selbst und das Ersetzen nur des Textes die beste Handschrift-Anpassung. Hinweis: Solche Wiederaufnahme-Handles können ablaufen (~1 Stunde) – dann zurückfallen auf frische Generierung aus dem Referenzbild; niemals Wiederaufnahme von Wiederaufnahme verketten.
  • Erste Versuche verrutschen oft einzelne Wörter. Ablehnen und erneut versuchen, wobei das Wort Buchstabe für Buchstabe im Prompt ausgeschrieben wird.

4. Größe und Strichstärke messen und korrigieren (der Composite-Durchgang)

Generationen kommen normalerweise überdimensioniert und zu schwer zurück. Korrigieren Sie als Pixel, nicht durch blindes Neugenerieren:

  • Erkennen Sie den Seitenrand (z. B. einen farbigen Randrahmen: grün = G übersteigt max(R, B) um >20; Randlinien aus Projektionsprofilen finden, äußerste starke Linie pro Seite; manuelle Überschreibung für schwache Ränder zulassen).
  • Bereinigen Sie das Innere mit zeilenweisem Papierfüller, der von der Seite selbst entnommen wurde (mittlere Papierfarbe pro Zeile).
  • Übertragen Sie nur Tinte: Erstellen Sie eine Alpha-Maske auf Basis der Dunkelheit und verdünnen Sie die Striche mit einer Dunkelheit^1.35-Kurve. Niemals ein Rechteck aus Papier+Tinte einfügen – ein eingefügter Papierblock hinterlässt geisterhafte Umrisse der alten Schrift und eine sichtbare Papiernaht, die als Streutinte druckt.
  • Skalieren Sie den Tintenblock so, dass seine mittlere Zeilenhöhe knapp UNTER dem Standard liegt (Ziel ~35 px bei einem 40-px-Standard – das Auge liest maßstabsgetreue Seiten als überdimensioniert).
  • Stellen Sie den ursprünglichen Randrahmen wieder her, überprüfen Sie erneut die Randintegrität und geben Sie die endgültige mittlere Zeilenhöhe als Nachweis aus.
  • Compositen Sie keine Tabellenseiten oder linierte Strukturen – lange Linien korrumpieren die Randerkennung und die Übertragung zieht Linien mit. Liefern Sie saubere Tabellengenerationen roh aus.

5. Farbe bewerten

Messen Sie Papier und Tinte auf der fertigen Seite (schließen Sie Randpixel von der Tintenprobe aus) und ordnen Sie sie pro Kanal mit einer affinen Transformation neu zu, die auf der Standardseite verankert ist: das Papier dieser Seite → Standardpapier, die Tinte dieser Seite → Standardtinte. (Denken Sie an das Vorzeichen: Tinte ist dunkler als Papier, also ist der Nenner negativ – Einklemmen invertiert die Bewertung.) Überprüfen Sie durch erneutes Messen: Papier und Tinte sollten innerhalb weniger RGB-Punkte des Standards liegen. Bewerten Sie jede generierte Seite; lassen Sie übernommene Drucke und die Standardseite selbst unverändert.

6. Zusammenstellen und offenlegen

  • Stellen Sie das PDF nur aus genehmigten Seiten zusammen, in der richtigen Reihenfolge, mit überprüfter Seitenzahl.
  • Liefern Sie ein Kontaktblatt aller Seiten, damit die Konsistenz auf einen Blick beurteilt werden kann.
  • Legen Sie bekannte Mängel klar offen (eine ausgelassene Phrase, eine ungefähre Kurve). Präsentieren Sie eine Korrektur niemals als erledigt, bevor sie eine visuelle Ausschnittsprüfung bestanden hat – eine numerische Sonde ist kein Auge.

Fehlermodi, die dieser Skill verhindern soll

  • Fotokopierte Seiten, die als "konvertiert" ausgeliefert werden (Quelle an den Generator gegeben; Nur-Text-Qualitätssicherung).
  • Ordentliche schriftartähnliche Handschrift auf einigen Seiten, Zielhandschrift auf anderen (kein einheitlicher Standard; Nur-Text-Prompts).
  • Seiten, die im Stil übereinstimmen, aber 20–30 % größer / dicker als die Referenz sind (keine maßstabsgetreue Messung).
  • Hellweißes Papier und harte schwarze Tinte, die von den weichen Tönen des Referenzfotos abweichen (kein Bewertungsschritt).
  • Geisterhafte Buchstaben im Hintergrund, die als Tinte drucken (Papierblock-Compositing anstelle von Nur-Tinte-Übertragung).
  • Neu gezeichnete Grafiken mit zerbrochener Geometrie (Neugenerierung dessen, was hätte übernommen oder pixelweise korrigiert werden sollen).
  • Ausufernder Umfang: Seiten neu bauen, die der Benutzer nie markiert hat.

Verwandte Skills