DariyXYZ/codex-skill-toolkit-for-claude

Claude zu Codex Skill Toolkit

Zweck

Den vollständigen Claude-zu-Codex-Skill-Lebenszyklus abdecken:

• ein GitHub-Repo oder lokales Skill-Verzeichnis inspizieren
• Shell-Snippets inspizieren, die manuell .claude/skills/<name>/skill.md erstellen
• den kürzesten sicheren Weg wählen: direkte Installation oder Migration
• den Installationshinweis klassifizieren, den der Benutzer in einem Claude-Tutorial gefunden hat
• Kompatibilität, Abhängigkeitsrisiko und Installationsstufe vor der Aktion bewerten
• erforderliche Metadaten für die Erkennung umschreiben, wenn nötig
• validieren, dass Codex das Ergebnis tatsächlich erkennen kann
• den fertigen Skill zur Wiederverwendung oder GitHub-Veröffentlichung paketieren

Verwenden Sie diesen Skill sowohl für einmalige Installationen als auch für den Aufbau eines wiederverwendbaren, polierten Codex-nativen Ports.

Automatische Aktivierung

Aktivieren, wenn die Anfrage Ideen wie die folgenden enthält:

• diesen Claude-Skill in Codex installieren
• diesen Claude Code-Skill migrieren
• diesen Skill zu Codex portieren
• diesen Skill für Codex anpassen
• wird dieser mkdir/printf .claude/skills/.../skill.md-Befehl wirklich einen Skill installieren
• warum wird dieser installierte Skill nicht angezeigt
• diesen migrierten Skill für GitHub paketieren
• prüfen, ob dieser Claude-Skill in Codex funktioniert

Behandeln Sie die folgenden als direkte Claude-orientierte Signale, selbst wenn der Benutzer nur "diesen Skill installieren" sagt und einen Link einfügt:

• GitHub-URLs oder owner/repo-Referenzen unter anthropics/, insbesondere anthropics/skills
• URLs, Repo-Namen oder Text, die Claude, Claude Code, Anthropic oder anthropics erwähnen
• Pfade oder Snippets, die .claude/skills, .claude-plugin, skill.json oder marketplace.json enthalten
• Befehle wie /plugin marketplace add, /plugin install oder /plugin add
• Claude-spezifische ZIP-Upload-Abläufe oder Skills-API-Referenzen

Wenn eines dieser Merkmale vorhanden ist, verwenden Sie diesen Skill zuerst, bevor Sie sich auf die reine Direktinstallation verlassen.

Schnelle Routenauswahl

Wählen Sie die kürzeste Route, die dennoch zuverlässig ist.

1. Wenn das Repo bereits eine saubere SKILL.md enthält und die Ordnerstruktur offensichtlich ist, installieren Sie zuerst den genauen Skill-Ordner und validieren Sie dann die Erkennung.
2. Wenn das Repo plattformspezifische Layouts wie .claude/skills, .claude-plugin oder skill.json enthält, überprüfen Sie diese Signale, bevor Sie entscheiden, dass es nicht installierbar ist.
3. Wenn der Benutzer ein Shell-Snippet bereitstellt, das .claude/skills/<name>/skill.md erstellt, behandeln Sie es als lokales Gerüst und überprüfen Sie den generierten Ordner, bevor Sie es als installiert betrachten.
4. Wenn das Repo Claude-spezifisch, mehrdeutig, Multi-Skill ist oder noch Claude-exklusive Annahmen verwendet, migrieren Sie, bevor Sie Erfolg melden.
5. Wenn die Aufgabe nur die Bewertung ist, überprüfen Sie das Repo und erklären Sie die Kompatibilität, ohne etwas zu installieren.
6. Wenn der Benutzer ein teilbares Artefakt möchte, erstellen Sie ein sauberes Codex-natives Paket mit minimaler Struktur und Validierungshinweisen.

Verwenden Sie scripts/inspect_skill_repo.py, wenn ein lokaler Ordner verfügbar ist und das Repo-Layout nicht offensichtlich ist. Verwenden Sie scripts/check_skill_md.py, wenn Sie eine deterministische Überprüfung auf Frontmatter- oder BOM-Probleme benötigen. Verwenden Sie scripts/classify_install_hint.py, wenn der Benutzer einen Claude-Tutorial-Befehl oder ein Installationssnippet einfügt und Sie es einer Codex-Route zuordnen müssen. Verwenden Sie scripts/trigger_score.py, wenn die Installierbarkeit in Ordnung aussieht, Sie aber wissen müssen, ob der Skill gut zu realen Benutzeranfragen passt. Verwenden Sie scripts/generate_install_report.py, um nach jeder Installationsprüfung eine lesbare Markdown-Analyse zu hinterlassen. Verwenden Sie scripts/install_skill_flow.py, wenn Sie einen halbautomatischen Routenauswähler wünschen, der auch einen ausgewählten lokalen Skill in Codex kopieren kann.

Kern-Workflow

1. Quelle inspizieren. Lesen Sie das Repo-Layout, lokalisieren Sie skills/, SKILL.md, Hilfsskripte und alle Claude-exklusiven Paketierungsannahmen.

2. Route entscheiden. Verwenden Sie references/compatibility-matrix.md, um zwischen direkter Installation, leichter Anpassung oder vollständiger Migration zu entscheiden. Wenn der Benutzer einen Tutorial-Befehl kopiert hat, normalisieren Sie ihn zuerst mit references/install-route-adaptation.md.

3. Kleinste sinnvolle Änderung durchführen.

• Direktinstallation, wenn die Quelle bereits Codex-freundlich ist.
• SKILL.md und unterstützende Dateien umschreiben, wenn die Erkennungs- oder Triggerqualität schwach ist.
• Lange Anleitungen in references/ aufteilen, wenn ein dauerhafter Codex-Port erstellt wird.
• Kompatibilitätsbewertung und Installationsstufe verwenden, um zu erklären, warum eine Route sicher oder riskant ist.
• Einen Installationsbericht erstellen, wenn das Ergebnis später überprüft, geteilt oder als Migrationsaufzeichnung verwendet wird.

4. Validieren, nicht annehmen. Immer überprüfen:

• der Skill-Ordner existiert am vorgesehenen Ort
• SKILL.md ist parser-freundlich
• die Datei ist UTF-8 ohne BOM
• codex debug prompt-input zeigt den Skill an, wenn das Ziel eine live Codex-Installation ist

5. Bei Bedarf sauber paketieren. Für GitHub oder zum Teilen einen kanonischen Skill-Ordner beibehalten mit:

• SKILL.md
• agents/openai.yaml, wenn nützlich
• references/ nur für Material, das es wert ist, bei Bedarf geladen zu werden
• scripts/ nur für deterministische Helfer

Schnellpfad für GitHub Skill-Repos

Wenn der Benutzer ein GitHub-Repo oder eine Skill-URL bereitstellt:

1. Zuerst das Repo-Root und skills/ inspizieren.
2. Auch .claude/skills, Root skill.json und .claude-plugin/plugin.json inspizieren, bevor entschieden wird, dass das Repo nur Dokumentation oder ein Katalog ist.
3. Wenn das Repo, der Besitzer, der Pfad oder der umgebende Text Claude-orientierte Signale wie anthropics/skills, Claude, Anthropic oder .claude/* trägt, in diesem Toolkit-Flow bleiben, auch wenn der Skill-Pfad offensichtlich aussieht.
4. Den genauen Skill-Ordner installieren, nicht das gesamte Repository, wenn der Zielpfad klar ist.
5. Die installierte SKILL.md sofort nach der Installation lesen.
6. Anhalten, wenn die Erkennung bereits sauber und die Triggerqualität akzeptabel ist.
7. Zur Migration wechseln, wenn der installierte Skill unsichtbar, vage benannt, fehlerhaft, schwach beschrieben oder noch Claude-exklusiv ist.

Bevorzugen Sie genaue --repo plus --path-Installationen, wenn Sie den Pfad sicher ableiten können.

Schnellpfad für lokale Claude Shell-Snippets

Wenn der Benutzer ein Shell-Snippet wie mkdir ... .claude/skills/... && printf ... > skill.md bereitstellt:

1. Als lokales Gerüst behandeln, nicht als Beweis, dass ein veröffentlichter Skill installiert wurde.
2. Das generierte Verzeichnis direkt inspizieren.
3. skill.md oder Skill.md zu SKILL.md normalisieren.
4. Markdown-Metadatenabschnitte bei Bedarf in YAML-Frontmatter konvertieren.
5. Erst nach der Normalisierung sollte behauptet werden, dass der Skill Codex-bereit ist.

Migrationsregeln

Wenn eine Migration erforderlich ist:

1. Verhalten bewahren, nicht die ursprüngliche Paketierung.
2. Das Frontmatter umschreiben, sodass name und description sowohl Funktion als auch Triggerphrasen klar ausdrücken.
3. Den Haupttext präzise und operativ halten.
4. Lange Playbooks, Zuordnungen und Fehlerbehebungen in references/ verschieben.
5. Doppelte Aliase vermeiden, es sei denn, es gibt einen echten Erkennungsgrund.

Für die vollständige Sequenz lesen Sie references/migration-playbook.md.

Erkennungsregeln

• "Auf der Festplatte installiert, aber in codex debug prompt-input fehlend" als fehlgeschlagene Installation behandeln.
• SKILL.md als UTF-8 ohne BOM speichern.
• Einen kanonischen Ordner pro Skill bevorzugen.
• Frontmatter einfach halten.
• Die description triggerreich machen, sodass Codex reale Benutzerformulierungen abgleichen kann.

Wenn die Erkennung defekt ist, verwenden Sie references/discovery-troubleshooting.md.

Paketierungsregeln

Beim Erstellen eines teilbaren Codex-nativen Ports:

• Den kanonischen Skill-Ordner selbst veröffentlichen
• Zusätzliche Dokumentationsdateien vermeiden, es sei denn, der Benutzer wünscht explizit Repo-orientierte Dokumentation
• Hilfsskripte generisch und deterministisch halten
• Keine duplizierten migrierten Varianten desselben Skills ausliefern
• Wenn ein Repo mehrere Skills enthält, jeden als eigenen Skill-Ordner paketieren

Erforderliche Validierung

Bevor die Migration als abgeschlossen gilt, überprüfen:

• scripts/check_skill_md.py <path-to-skill-md> meldet keine blockierenden Probleme
• scripts/inspect_skill_repo.py <path-to-skill-folder> zeigt die erwartete Struktur
• Kompatibilitätsbewertung, Abhängigkeitsprofil und Installationsstufe sind für die gewählte Route sinnvoll
• Die Triggerqualität ist gut genug für realistische Eingabeaufforderungen, oder der Bericht erklärt klar, warum noch Migrationspolitur erforderlich ist
• codex debug prompt-input zeigt den Skill an, wenn er in ein live Codex-Skills-Verzeichnis installiert wird

Referenzleitfaden

Lesen Sie nur, was benötigt wird:

• references/migration-playbook.md für die durchgängige Migrationssequenz
• references/compatibility-matrix.md für die Routenauswahl
• references/install-route-adaptation.md zum Übersetzen von Claude-Installations-Tutorials in Codex-Aktionen
• references/install-workflow.md für das halbautomatische Installationsmuster
• references/discovery-troubleshooting.md für die Fehleranalyse