CODEZ Originalleitfaden / 01
Agent Skills auswählen: Vom Sterne-Ranking zum eigenen Versuch
Listen können die Suche eingrenzen. Die tatsächliche Auswahl hängt davon ab, ob eine Fähigkeit eine bestimmte Aufgabe in Ihrem Umfeld erfüllen kann. Dieser Leitfaden bietet eine wiederverwendbare Filtermethode.
Datenprüfung:
Format und Projektfakten stammen aus den verlinkten Originalquellen; Auswahlablauf und Abnahmekriterien sind redaktionelle Empfehlungen von CODEZ. Die PDF-Kandidaten sind tatsächlich erfasste Einträge, deren Originaltexte bei festgelegten Commits verglichen wurden. Diese fremden Skills wurden nicht ausgeführt; die Beispiele sind keine gemessenen Testergebnisse.
01 / Ermitteln Sie zunächst, welche Fähigkeiten Sie benötigen.
Agent Skills sind meist in Ordnern organisiert. SKILL.md enthält Metadaten und Aufgabenbeschreibungen; Skripte, Referenzen und Vorlagen können hinzukommen. Das Feld compatibility in der Formatspezifikation kann Anforderungen an die Umgebung angeben, ist aber optional. Prüfen Sie daher auch ohne diesen Eintrag den Text und die Abhängigkeiten.
Zuerst sollten Sie die Eingabe-, Ausgabe- und Akzeptanzkriterien festlegen. Zum Beispiel: „Tabellen aus PDFs mit Textebenen in CSV-Dateien extrahieren und dabei die Spaltennamen beibehalten.“ „Hilfe bei der Dokumentenverarbeitung“ ist zu allgemein und erschwert die Beurteilung, ob ein Kandidat geeignet ist.
02 / Was Repository-Sterne aussagen
GitHub-Sterne können verwendet werden, um Projekte zu speichern und die Arbeit der Projektbetreuer zu würdigen. Daher nutzen wir sie als Indikator für die Popularität eines Projekts.
Diese Website verwendet Sterne für das Ranking von Repositorys. Ein Repository mit Hunderten von Fähigkeiten kann nur durch einen Teil seiner Inhalte Aufmerksamkeit erregen; die Gesamtanzahl der Sterne eines Repositorys kann nicht jeder einzelnen Fähigkeit zugeordnet werden. Beim Vergleich von Fähigkeiten aus zwei Repositories wird zunächst die Eignung für die jeweilige Aufgabe und anschließend die Popularität als sekundäres Kriterium bewertet.
Das Datum der letzten Aktualisierung hilft lediglich bei der Informationssuche. Eine einzelne, nicht damit zusammenhängende Änderung bedeutet nicht, dass die benötigte Funktion behoben wurde; überprüfen Sie daher die Commits, Beispiele und Fehlerprotokolle des entsprechenden Verzeichnisses.
03 / Anforderungen in überprüfbare Kriterien übersetzen
Die folgenden Bedingungen sind leichter zu interpretieren und zu überprüfen als eine einzelne Beliebtheitsrangliste. Die Anzahl der von den Kandidaten erfüllten Bedingungen muss nicht zu einer scheinbar präzisen Gesamtpunktzahl zusammengefasst werden.
| Szenario | Zuerst prüfen | Beobachten Sie die Anwendung während der Testphase. |
|---|---|---|
| Dokumenten- und Tabellenkalkulationsverarbeitung | Eingabetyp, Ausgabeformat, Systemabhängigkeiten | Gehen Spaltennamen, Zeichenkodierung, Layout oder Daten verloren? |
| Code- und Entwicklungs-Workflow | Zielsprache, Framework-Version und benötigte Tools | Umfang der Änderungen, Fehlermeldungen und ob das Projekt die Inspektion besteht. |
| Recherche und Aufbereitung von Quellen | Quellenumfang, Zitieranforderungen und Netzwerkbedingungen | Lassen sich die Zitate zurückverfolgen? Geht die Schlussfolgerung über die Beweislage hinaus? |
04 / Öffnen Sie die Originaldatei und überprüfen Sie die Umgebung und den Betriebsumfang.
Öffnen Sie SKILL.md über unsere Karte und lesen Sie dann die README im selben Ordner. Eine chinesische README hilft beim Verständnis, doch vollständige Sprachversionen belegen nicht die Eignung des Skills. Fehlt eine chinesische Version, prüfen Sie die entscheidenden Bedingungen im Original.
Notieren Sie sich diese Informationen, bevor Sie es ausprobieren:
- Betriebsumgebung: Unterstützte Clients, Betriebssysteme, Befehlszeilentools und explizit angegebene Versionsanforderungen.
- Umfang der Operation: Welche Dateien gelesen oder geändert werden, welche externen Dienste aufgerufen werden und ob Anmeldeinformationen erforderlich sind.
- Zusätzliche Ressourcen: Existieren die im Text erwähnten Skripte und Referenzdateien? Was bewirken die ausgeführten Befehle?
- Nutzungsbedingungen: Lesen Sie die Lizenzdateien des Projekts und des Skill-Ordners. Unsere Kennzeichnungen „Nicht angegeben“ oder „Prüfung ausstehend“ bedeuten, dass die Angaben noch nicht bestätigt sind.
- Angaben zur Reproduktion: Halten Sie Repository-Adresse, konkreten Skill-Pfad und Commit-Version des Versuchs fest, damit Sie später dieselben Inhalte wiederfinden.
05 / Kandidaten anhand derselben Teilaufgabe vergleichen
Wählen Sie zwei oder drei Kandidaten aus, die am besten zur Aufgabe passen, und testen Sie diese mit denselben unkritischen Eingaben in einer wiederherstellbaren Testkopie. Aktivieren Sie beim ersten Mal nur die Funktionen, die Sie aktuell benötigen, und befolgen Sie dabei die Installationsanweisungen für den jeweiligen Client.
Definieren Sie vor Beginn die Erfolgsbedingungen. Prüfen Sie bei der Tabellenextraktion die Zeilenanzahl, Spaltennamen und Nullwerte; bei Codeänderungen die Zielfunktionalität, geänderte Dateien und bestehende Projektprüfungen. Protokollieren Sie bei einem Fehler die Fehlermeldung und die Umgebung; schreiben Sie den Fehler nicht sofort dem Modell oder der Fähigkeit selbst zu.
Dokumentieren Sie alle notwendigen manuellen Korrekturen, zusätzlichen Werkzeuge, Kosten externer Dienstleister und die Bearbeitungszeit. Eine einheitliche Dokumentationsmethode für wiederkehrende Aufgaben erleichtert die Entscheidungsfindung im Vergleich zur alleinigen Betrachtung des Ergebnisses.
- Kandidat und Version: Repository / Skill-Pfad / Commit.
- Eingabe und Umgebung: Beispiel / Betriebssystem / Client und Abhängigkeiten.
- Ergebnisse und Korrekturen: Welche Abnahmepunkte bestanden wurden und welche eine manuelle Bearbeitung erforderten.
- Ressourcen und Entscheidungen: In Anspruch genommene Leistungen, Zeitaufwand und Kosten sowie Gründe für die Annahme oder Verschiebung.
06 / Konkrete Kandidaten: Zwei PDF-Skills mit gleichem Namen vergleichen
Unsere Website erfasst skills/pdf/SKILL.md aus anthropics/skills und skills/.curated/pdf/SKILL.md aus openai/skills. Beide Skills heißen pdf; notieren Sie zuerst Repository und vollständigen Pfad, um gleichnamige Einträge nicht für dieselben Anweisungen zu halten. Die folgende Tabelle vergleicht die Aufgabenschwerpunkte im Original, behauptet keine gegenseitig ausschließenden Fähigkeiten und nutzt Sterne nicht zur Bewertung der Genauigkeit.
Das Anthropic-Dokument enthält Beispiele für verschiedene PDF-Manipulationstechniken, darunter Text- und Tabellenextraktion, Seitenmanipulation, Generierung und OCR gescannter Dokumente, und verweist für die Formularverarbeitung auf FORMS.md. Das OpenAI-Dokument betont das Lesen, Erstellen und Überprüfen des Layouts und erfordert Kontrollen nach dem Seitenrendering sowie nach wesentlichen Aktualisierungen; die Textextraktion allein reicht nicht aus, um die Korrektheit des Layouts nachzuweisen.
| Kandidat und vollständiger Pfad | Schwerpunkte des Originals | CODEZ empfiehlt, dies zuerst zu überprüfen. | Muss noch überprüft werden. |
|---|---|---|---|
| anthropics/skills / skills/pdf/SKILL.md | Für jeden Vorgang werden Beispiele bereitgestellt: Extraktion, Seitenverarbeitung, Generierung und OCR. | Beim Extrahieren von Tabellen oder Verarbeiten gescannter Dokumente sollten Sie zunächst die entsprechenden Operationen und Abhängigkeiten überprüfen. | Tabellenstruktur, OCR-Sprache und -Genauigkeit, Verfügbarkeit zitierter Quellen und Werkzeuge |
| openai/skills / skills/.curated/pdf/SKILL.md | Erstellen, überprüfen und das Layout durch Seitenrendering kontrollieren. | Wenn ein lesbarer Bericht erforderlich ist, überprüfen Sie zunächst den Rendering- und Inspektionsprozess. | Schriftarten, Tabellen, Seitenzahlen und Paginierung; ob der Text in einer realen Umgebung dargestellt werden kann. |
anthropics/skills: skills/pdf/SKILL.md (festgelegter Commit) ↗
openai/skills: skills/.curated/pdf/SKILL.md (festgelegter Commit) ↗
07 / Unterteilen Sie die "Erfolgreiche Extraktion" in überprüfbare Akzeptanzkriterien.
Nachfolgend ein Vorschlag für die Testdurchführung: Vergleichen Sie die Kandidaten anhand derselben zweiseitigen, nicht sensiblen Inventarliste. Die Liste enthält die Materialnummer 0017, chinesische Spaltennamen, eine leere Beschreibungsspalte, eine doppelte Kopfzeile auf der zweiten Seite und eine verbundene Zelle. Überprüfen Sie zunächst manuell die erwarteten Ergebnisse und bewahren Sie dabei die Seitenzahl der Quellseite sowie eine Kopie des Originaldokuments auf. Dies ist kein Testlauf.
Prüfen Sie vor Beginn, ob Text im Eingabedokument ausgewählt werden kann, und versuchen Sie eine kleine Extraktion. Auswahl und Extraktion liefern nur Hinweise: Eine Textebene garantiert keine korrekte Tabellenstruktur, und bereits vorhandener OCR-Text eines Scans kann Fehler enthalten. Wenn OCR nötig ist, notieren Sie Sprache und Systemwerkzeuge; erfassen Sie fehlende Abhängigkeiten als Umgebungsproblem.
- Notieren Sie Kandidaten-Commit, Client, Modell, Tool-Versionen und Eingabetyp, damit Unterschiede in der Umgebung nicht fälschlich als Skill-Unterschiede gelten.
- Manuell korrigierte Zeilen und Gründe, Laufzeit und tatsächlich aufgerufene Dienste werden protokolliert; nicht gemessene Daten sollten leer gelassen werden.
- Die entsprechende Schlussfolgerung wird nur akzeptiert, wenn alle aufgeführten Akzeptanzkriterien erfüllt sind. Selbst wenn eine Stichprobe die Kriterien erfüllt, muss Ihre tatsächliche Eingabe noch überprüft werden.
| Prüfpunkte | Zu prüfende Ergebnisse | Wie man mit Misserfolgen umgeht |
|---|---|---|
| Materialnummer | 0017 behält führende Nullen bei und kann nicht automatisch in 17 geändert werden. | Nachdem die Feldtypen geklärt wurden, extrahieren Sie die Daten erneut und überprüfen Sie jedes einzelne Element. |
| Seitenübergreifende Tabelle | Die Kopfzeile der zweiten Seite wird nicht als Daten gezählt, und es gehen keine Datensätze verloren oder werden dupliziert. | Behalten Sie die Seitenzahlen bei, überprüfen Sie die Zeilenanzahl auf jeder Seite und fügen Sie die Seiten anschließend zusammen. |
| Chinesische Schriftzeichen und Nullwerte | Spaltennamen sind lesbar; leere Beschreibungen bleiben leer, ohne erfundene Inhalte. | Überprüfen Sie die Kodierung und die Feldpositionen und markieren Sie die Positionen, die nicht wiederhergestellt werden können. |
| Zusammengeführte Zellen | Beschreibungstexte gehören zu den richtigen Datensätzen; Aufteilungsregeln sind ausdrücklich dokumentiert. | Die Quellregion bleibt erhalten, und die Zuordnungsregeln werden manuell festgelegt. |
| Ausgabeberichtformat | Der gerenderte Inhalt weist keine Kürzungen, Überlappungen oder fehlende Zeichen auf. | Korrigieren Sie die Schriftart oder das Layout und überprüfen Sie die neueste Darstellung. |
08 / Kategorien, Lizenzen und Abhängigkeiten sind drei separate Prüfungen
Die beiden PDF-Einträge wurden anhand ihrer Originaltexte von „Design“ beziehungsweise „Entwicklung“ zu „Dokumente“ korrigiert. Zentrale Ein- und Ausgaben sind PDFs; Python-Code und Rendering-Werkzeuge dienen der Durchführung. Eine einzelne Kategorie hilft nur bei der Kandidatensuche und entscheidet nicht, ob Extraktion oder Layoutprüfung besser passt.
Beide Einträge enthalten eigene LICENSE.txt-Dateien im jeweiligen Verzeichnis. Diese Website kennzeichnet die Lizenzdatei mit dem Hinweis „Lizenzprüfung ausstehend“. Bitte lesen Sie die Originallizenzen der einzelnen Verzeichnisse. Gehen Sie nicht davon aus, dass die Inhalte frei nutzbar sind, nur weil das Repository öffentlich zugänglich ist oder die zugehörige Organisation bekannt ist.
Die Abhängigkeitsliste sollte für jeden einzelnen Vorgang geprüft werden. Die Installation von Python-Bibliotheken bedeutet nicht, dass die System-Rendering-Tools oder die OCR-Umgebung verfügbar sind; dieses Dokument garantiert keine Kompatibilität mit Clients. Notieren Sie fehlende Tools, nicht verifizierte Schritte und Nutzungsbeschränkungen in Ihrem Entscheidungsprotokoll.
09 / Cloudflare Skill: zuerst Projektkonfiguration und Zugangsdaten prüfen
Am 2026-10-14 wurden für diesen Abschnitt der feste Commit von cloudflare/skills / skills/cf-cli/SKILL.md und die offizielle Dokumentation geprüft. Dies sind Auswahl- und Testempfehlungen von CODEZ; dieser Skill wurde nicht ausgeführt.
cf verwendet eine Wrangler-Anmeldung nicht erneut. Zuerst Konto und Token-Berechtigungen prüfen; CLI-Version, Konfiguration und Zielressourcen festhalten, damit Umgebungsunterschiede nicht als Skill-Unterschiede bewertet werden.
| Szenario | Zuerst prüfen | Beobachten Sie die Anwendung während der Testphase. |
|---|---|---|
| wrangler.jsonc, wrangler.json oder wrangler.toml ist vorhanden, cloudflare.config.ts jedoch nicht | Zunächst den Wrangler-Ablauf für dev, build und deploy beibehalten; cf-Projektbefehle lesen diese vorhandene Konfiguration nicht. | Zuerst die vom Skill vorgeschlagenen Befehle und Dateiänderungen prüfen; über eine Konfigurationsmigration gesondert entscheiden. |
| cloudflare.config.ts ist bereits vorhanden | dev, build und deploy anhand des cf-Projektablaufs prüfen; die CLI ist in beta, und eine Kategorie belegt keine Kompatibilität. | Node.js 22.18 oder neuer und das Zielkonto prüfen; Build-Ausgabe und Ziel-Worker in einer Testkopie kontrollieren. |
cloudflare/skills / skills/cf-cli/SKILL.md ↗
Cloudflare: offizieller Vergleich von CLI und Wrangler ↗
Cloudflare: offizielle Anforderungen für Installation und Anmeldung ↗