Ein Dokument in einen Skill verwandeln

Tutorial · 6 Min. Lesezeit

Das Wissen, das ein Agent haben soll, steht meist schon irgendwo geschrieben — ein Onboarding-PDF, ein Styleguide in Word, ein Runbook in Markdown. Es fehlt nicht am Wissen. Es liegt daran, dass ein Dokument für einen Menschen geschrieben ist, der es von vorn bis hinten liest, während ein Skill für einen Agenten funktionieren muss, der ihn mitten in einer Aufgabe lädt und handeln soll.

Skilnu kann den ersten Durchgang dieser Umwandlung übernehmen. Laden Sie ein Dokument hoch, und Sie erhalten einen SKILL.md-Entwurf — das zentrale Modell, die Definitionen, die Handlungsanweisungen, umgebaut zu Anweisungen. Nichts wird veröffentlicht. Sie lesen ihn, korrigieren, was nicht stimmt, und veröffentlichen, wenn Sie zufrieden sind — genau wie bei jedem anderen Skill.

1. Das Dokument hochladen

Öffnen Sie in der App + New skill und klicken Sie auf Draft from a document, neben „SKILL.md hochladen“. Wählen Sie Ihre Datei und warten Sie — das dauert länger als der Rest der App, weil ein ganzes Dokument gelesen und neu geschrieben werden muss.

Diese Formate funktionieren: .pdf, .docx, .txt, .md, .markdown, .rst und .adoc.

Alles andere wird abgelehnt, bevor es hochgeladen wird. Wenn Ihr Format nicht auf dieser Liste steht, exportieren Sie es zuerst als PDF — dieser Weg ist gut abgedeckt.

2. Schicken Sie einen Abschnitt, keine Bibliothek

Es gibt eine Längenbegrenzung von etwa 40.000 Zeichen extrahiertem Text, also ungefähr ein langes Kapitel. Darüber wird der Upload abgelehnt statt still abgeschnitten — ein Skill, der aus den ersten 40.000 Zeichen eines 300-seitigen Buchs entworfen und Ihnen als aus dem Buch entworfen übergeben wird, wäre schlimmer als ein Fehler.

Das schränkt weniger ein, als es klingt, denn was einen guten Skill ausmacht, ist genau das, was hineinpasst: ein zusammenhängendes Thema. „Unsere Code-Review-Standards“ ist ein Skill. „Das gesamte Engineering-Handbuch“ ist ein Ordner voll davon. Bei einem großen Dokument teilen Sie es nach Kapiteln und entwerfen jedes einzeln — Sie bekommen ohnehin bessere Skills, als ein Durchgang über das Ganze produziert hätte.

3. Gescannte PDFs brauchen zuerst OCR

Ein PDF, das in Wahrheit aus Fotografien von Seiten besteht, enthält keinen Text zum Extrahieren; der Entwurf kommt deshalb mit einem entsprechenden Hinweis zurück statt als leerer Skill. Schicken Sie es zuerst durch ein beliebiges OCR-Werkzeug — die meisten PDF-Programme haben „Text erkennen“ eingebaut — und laden Sie die durchsuchbare Fassung hoch.

Ein schneller Test: Öffnen Sie das PDF und versuchen Sie, einen Satz zu markieren. Wenn das nicht geht, ist es ein Bild.

4. Den Entwurf gründlich lesen

Der Entwurf landet im Verfassen-Formular, Name und Beschreibung aus seinem eigenen Frontmatter ausgefüllt. Es ist ein erster Durchgang eines Modells, das Ihr Dokument einmal gelesen hat — lesen Sie ihn wie den ersten Versuch einer kompetenten Kollegin, nicht wie fertige Arbeit.

Drei Dinge lohnen jedes Mal eine Prüfung:

Hat er das Konkrete behalten? Commands, thresholds, names of internal tools, the actual numbers. These are the most useful part of a skill and the easiest thing to lose when prose gets condensed.

Hat er etwas erfunden? The draft is told to stay inside what the document supports, but if your document was vague somewhere, check that the draft was vague in the same place rather than confidently filling the gap.

Sind es Anweisungen oder eine Zusammenfassung? The failure mode to watch for is a draft that describes what the document says instead of telling the agent what to do. If a section reads like a book report, rewrite it as a rule.

5. Veröffentlichen

Bearbeiten Sie das Formular, bis Sie zufrieden sind, und veröffentlichen Sie dann wie gewohnt. Ab da ist es ein ganz normaler Skill: Er kann versioniert werden, andere Skills können von ihm abhängen, Sie können ihn mit Ihrem Team teilen und in Ihre MCP-Bibliothek aufnehmen.

Das Ganze aus einem Agenten heraus

Derselbe Ablauf steht über MCP zur Verfügung, als zwei Werkzeuge, weil die Datei zwischendurch in den Speicher gelangen muss. Fordern Sie eine Upload-URL an, senden Sie die Bytes, und fragen Sie dann nach dem Entwurf:

get_document_upload_url(filename="handbook.pdf")
  -> { upload_url, document_key }

PUT the file's bytes to upload_url
  (no auth header -- the URL is already signed)

draft_skill_from_document(document_key=...)
  -> { name, description, skill_md }

Die Agenten-Variante nimmt zusätzlich ein instructions-Argument entgegen, das das Web-Formular nicht anbietet und das hier wirklich nützlich ist — „konzentriere dich auf Kapitel 3“, „schreib es für jemanden, der neu im Thema ist“, „behalte jedes Codebeispiel“. Es kommt zu Ihren dauerhaften Kompilierungsanweisungen hinzu, statt sie zu ersetzen.

Wie überall sonst erstellt draft_skill_from_document nur einen Entwurf. Das Ausliefern ist ein eigener publish_skill-Aufruf, ein Agent kann ein Dokument also nicht in einen veröffentlichten Skill verwandeln, ohne dass Sie den Entwurf zuerst gesehen haben.

Was es kostet

Jeder Entwurf verbraucht eine Einheit Ihres täglichen Kompilierungskontingents, auf dem Modell, das Sie in den Einstellungen gewählt haben — dasselbe Budget wie beim Veröffentlichen mit Kompilierung. Ein fehlgeschlagener Entwurf, der das Modell nie erreicht hat, etwa bei einer nicht unterstützten Datei oder einer über der Längengrenze, verbraucht nichts.

Ihr hochgeladenes Dokument ist Zwischenspeicher. Es wird gelöscht, sobald der Entwurf erzeugt ist, ob erfolgreich oder nicht, und was das trotzdem übersteht, verschwindet binnen 24 Stunden. Es ist nie Teil des veröffentlichten Skills — nur der Entwurf, den Sie prüfen, ist es.

Wofür sich das eignet

Die besten Kandidaten sind Dokumente, die bereits eine Arbeitsweise kodieren: ein Styleguide, eine Review-Checkliste, ein Incident-Runbook, das Kapitel eines Fachbuchs, das ein Agent anwenden statt zitieren soll. Nachschlagematerial ohne Vorgehen darin — ein API-Dump, ein Glossar, eine als PDF exportierte Tabelle — ergibt einen dünnen Skill, weil in der Quelle keine Anleitung steckt.

Ein guter Test vor dem Hochladen: Könnte jemand dieses Dokument lesen und danach etwas anders machen? Wenn ja, wird ein Skill daraus. Wenn es nur etwas zum Nachschlagen ist, vermutlich nicht.