Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Fehler bei der Einreichung von Plugins

Validierungsfehler bei der Einreichung von Plugins für das öffentliche Verzeichnis finden und beheben

Für Plugins, die du für das öffentliche Verzeichnis einreichst, gelten strengere Anforderungen als für Plugins, die du in einem Workspace installierst. Bei der Einreichung für das Verzeichnis muss das Paket die allgemeinen Paketprüfungen bestehen. Zusätzlich werden die Felder des Verzeichniseintrags, die Prüfunterlagen, MCP-Tools, Skills, Assets und Bilder geprüft. Diese Referenz behandelt auch allgemeine Paketprüfungen, etwa für Verweise auf MCP-Server. Die zugehörigen Fehler können auch außerhalb des Einreichungsportals auftreten.

Anhand des Fehlercodes, den du bei der Einreichung erhältst, findest du die zugehörige Anforderung. Fehler verhindern die Einreichung. Bei Warnungen kannst du fortfahren, solltest sie aber vorher prüfen.

Werte, die nicht leer sein dürfen, müssen mindestens ein Zeichen enthalten, das kein Leerraumzeichen ist. In Textfeldern sind Steuerzeichen, Unicode-Zeilen- und Absatztrenner sowie nicht unterstützte unsichtbare Formatierungszeichen unzulässig. HTTPS-URLs müssen einen Host enthalten. Eingebettete Zugangsdaten und nicht unterstützte Zeichen sind darin unzulässig.

Endgültige Einreichung für das Verzeichnis

Ein Paket kann die Prüfung beim Upload bestehen und bei der endgültigen Einreichung für das Verzeichnis trotzdem abgelehnt werden. Bei der endgültigen Einreichung gelten strengere Grenzwerte für den Verzeichniseintrag. Außerdem werden die MCP-Konfiguration, die Skill-Scans, die Testfälle und die Bestätigungen zur Einhaltung der Richtlinien geprüft.

Feld Anforderungen bei der endgültigen Einreichung
Paketname Pflichtfeld, höchstens 64 Zeichen. Beginne mit einem ASCII-Buchstaben oder einer ASCII-Ziffer und verwende ausschließlich ASCII-Buchstaben, ASCII-Ziffern, _ und -.
Version Pflichtfeld. Verwende eine semantische Versionsnummer mit höchstens 64 Zeichen.
Anzeigename Pflichtfeld, eine Zeile, höchstens 30 Zeichen.
Kurzbeschreibung Pflichtfeld, eine Zeile, höchstens 30 Zeichen.
Ausführliche Beschreibung Pflichtfeld, höchstens 4.000 Zeichen. Zeilenumbrüche sind zulässig.
Entwicklername Pflichtfeld, eine Zeile, höchstens 80 Zeichen.
Kategorie Pflichtfeld. Wähle eine der unterstützten Kategorien im Abschnitt Fehler im Verzeichniseintrag und in der Oberfläche.
Funktionen Höchstens 20. Jede Funktionsangabe muss Text enthalten und in eine Zeile passen. Sie darf höchstens 120 Zeichen lang sein.
Einstiegsprompts Höchstens 3. Jeder Prompt muss Text enthalten, nach der Normalisierung von Unicode und Leerraum eindeutig sein und in eine Zeile passen. Er darf höchstens 128 Zeichen lang sein und keine @mention eines MCP-Servers enthalten.
URLs Bei der Einreichung von Remote-MCP-Servern erforderlich, bei ZIP-Uploads für reine Skill-Plugins optional. Die URLs für Website, Support, Datenschutzrichtlinie und Nutzungsbedingungen müssen HTTPS verwenden und dürfen jeweils höchstens 1.024 Zeichen lang sein.
Markenfarben Optional. Verwende sechsstellige Hex-Farbcodes. Die helle Farbe muss zu Weiß und die dunkle Farbe zu #212121 jeweils ein Kontrastverhältnis von mindestens 2:1 aufweisen.

Für jede Plugin-Einreichung gelten außerdem folgende Anforderungen:

  • Jeder mitgelieferte Skill muss die Scans auf schädliche Inhalte und Sicherheitsrisiken bestehen. Die Scans können bis zu 2 Stunden dauern.
  • Die Identität der entwickelnden Person oder des Unternehmens muss verifiziert sein. Alle erforderlichen Bestätigungen zur Einhaltung der Richtlinien müssen vorliegen.

Für die endgültige Einreichung eines Remote-MCP-Plugins benötigst du außerdem:

  • URLs für Website, Support, Datenschutzrichtlinie und Nutzungsbedingungen, die den oben genannten Anforderungen entsprechen.
  • Eine URL zu einer Demo-Aufzeichnung, die die wichtigsten Anwendungsfälle und Tools auf den unterstützten Plattformen zeigt.
  • Genau fünf positive Testfälle, drei negative Testfälle und Versionshinweise.
  • Eine HTTPS-URL für den MCP-Server im Produktivbetrieb, eine erfolgreich abgeschlossene Domainverifizierung und einen aktuellen, erfolgreichen Tool-Scan.
  • Explizite Werte für readOnlyHint, openWorldHint und destructiveHint bei jedem MCP-Tool sowie eine Begründung für jeden Wert.
  • Demo-Zugangsdaten, die das Prüfteam direkt verwenden kann, wenn der Server OAuth verwendet.

Metadatenfehler bei der endgültigen Einreichung

In diesen Fehlercodes steht subtitle für die Kurzbeschreibung und description für die ausführliche Beschreibung.

Name Anforderung
submission_display_name_required Der Anzeigename ist erforderlich, darf nicht leer sein und muss in eine Zeile passen.
submission_display_name_too_long Der Anzeigename darf höchstens 30 Zeichen lang sein.
submission_display_name_character_unsupported Der Anzeigename darf nur unterstützte Zeichen enthalten und muss in eine Zeile passen.
submission_subtitle_required Die Kurzbeschreibung ist erforderlich, darf nicht leer sein und muss in eine Zeile passen.
submission_subtitle_too_long Die Kurzbeschreibung darf höchstens 30 Zeichen lang sein.
submission_subtitle_character_unsupported Die Kurzbeschreibung darf nur unterstützte Zeichen enthalten und muss in eine Zeile passen.
submission_description_required Die ausführliche Beschreibung ist erforderlich und darf nicht leer sein. Zeilenumbrüche sind zulässig.
submission_description_too_long Die ausführliche Beschreibung darf höchstens 4.000 Zeichen lang sein.
submission_description_character_unsupported Die ausführliche Beschreibung darf nur unterstützte Zeichen enthalten. Zeilenumbrüche sind zulässig.
submission_developer_name_required Der Entwicklername ist erforderlich, darf nicht leer sein und muss in eine Zeile passen.
submission_developer_name_too_long Der Entwicklername darf höchstens 80 Zeichen lang sein.
submission_developer_name_character_unsupported Der Entwicklername darf nur unterstützte Zeichen enthalten und muss in eine Zeile passen.
plugin_capability_invalid Jede Funktionsangabe muss Text enthalten, darf nur unterstützte Zeichen verwenden, muss in eine Zeile passen und darf höchstens 120 Zeichen lang sein.
plugin_default_prompt_mention Einstiegsprompts dürfen keine @mentions von MCP-Servern enthalten.
plugin_default_prompt_duplicate Einstiegsprompts müssen nach der Normalisierung von Unicode und Leerraum eindeutig sein.

Fehler bei der MCP-Konfiguration und den Prüfunterlagen

Diese Fehler betreffen die Einreichung von Remote-MCP-Servern.

Name Anforderung
annotations_required Für jedes MCP-Tool müssen readOnlyHint, openWorldHint und destructiveHint so gesetzt sein, dass sie das Verhalten des Tools korrekt beschreiben.
justification_required Begründe für jede Annotation eines MCP-Tools den gewählten Wert. Gehe je nach Annotation darauf ein, ob das Tool ohne Schreibzugriff arbeitet, mit externen Systemen interagiert oder destruktive Aktionen ausführt.
scan_required Für die MCP-Tools muss ein aktueller, erfolgreicher Scan des MCP-Servers im Produktivbetrieb vorliegen.
domain_verification_required Stelle das Verifizierungstoken unverändert unter der generierten URL /.well-known/openai-apps-challenge auf dem MCP-Host oder einem zulässigen übergeordneten Host bereit. Die Prüfung über Domain verifizieren muss erfolgreich sein.
frame_domain_explanation_required Erkläre für jede externe Frame-Domain, die der MCP-Tool-Scan meldet, warum die Benutzeroberfläche sie benötigt und welche Inhalte sie bereitstellt.

Archivfehler

Fehler und Warnungen beim ZIP-Upload

Über die Option Nur Skills im Portal kannst du Skill-Pakete im ZIP-Format und genehmigte lokale MCP-Plugins hochladen. Genehmigte lokale MCP-Plugins müssen keine Skills enthalten. Fehler verhindern den Upload. Warnungen musst du bestätigen.

Name Anforderung
plugin_name_mismatch Bei einem Update muss der Paketname mit dem Namen des vorhandenen Plugins übereinstimmen.
plugin_version_unchanged Für eine neue Veröffentlichung musst du im Manifest eine andere version angeben. Wenn du die bereits veröffentlichte Version wiederverwendest, musst du das bestätigen.
mcp_configuration_excluded Die MCP-Konfiguration wird ausgeschlossen, sofern deine Organisation keine Genehmigung für lokale MCP-Einreichungen hat. Lass dir bei einem lokalen MCP-Plugin von deiner Ansprechperson bei OpenAI bestätigen, dass die einreichende Organisation freigeschaltet ist. Reiche Remote-MCP-Server über Mit MCP ein.
app_configuration_excluded ZIP-Uploads dürfen weder apps noch .app.json enthalten. Reiche Remote-MCP-Server über Mit MCP ein. Für lokale MCP-Server gilt die Anleitung zur Einreichung für den Desktop.
claude_format_normalized Das Portal konvertiert .claude-plugin/plugin.json in .codex-plugin/plugin.json. Dabei ergänzt es fehlende Standardwerte für die Oberfläche und fügt normalisierte Textfelder hinzu.
manifest_normalized Das Portal speichert das normalisierte Manifest als .codex-plugin/plugin.json. Änderungen an Feldern musst du bestätigen.
developer_name_defaulted Das Portal übernimmt den Entwicklernamen für den Verzeichniseintrag automatisch aus der ausgewählten verifizierten Entwickleridentität, unabhängig vom Namen im ZIP-Archiv.

Fehler bei ZIP-Struktur und Größenbeschränkungen

Name Anforderung
archive_empty Das Archiv darf nicht leer sein.
archive_too_large Das komprimierte ZIP-Archiv darf höchstens 100 MB groß sein.
archive_format_not_zip Das Archiv muss eine gültige, unbeschädigte ZIP-Datei sein.
archive_member_path_empty Der Pfad eines Archiveintrags darf nicht leer sein.
archive_member_path_has_outer_whitespace Der Pfad eines Archiveintrags darf weder mit Leerraum beginnen noch mit Leerraum enden.
archive_member_path_has_backslash Verwende im Pfad eines Archiveintrags / als Trennzeichen. Backslashes sind unzulässig.
archive_member_path_absolute Der Pfad eines Archiveintrags muss relativ zum Stammverzeichnis des Archivs sein.
archive_member_path_has_empty_segment Der Pfad eines Archiveintrags darf keine leeren Segmente enthalten.
archive_member_path_has_parent_segment Der Pfad eines Archiveintrags darf keine ..-Segmente enthalten.
archive_member_path_too_deep Der Pfad eines Archiveintrags darf einschließlich des Dateinamens höchstens 20 Segmente enthalten.
archive_member_path_too_long Der Pfad eines Archiveintrags darf die unterstützte Pfadlänge nicht überschreiten.
archive_member_path_normalization_collision Die Pfade der Archiveinträge müssen auch nach der Vereinheitlichung der Groß- und Kleinschreibung und der Unicode-Normalisierung eindeutig sein.
archive_member_type_unsupported Archiveinträge müssen reguläre Dateien oder Verzeichnisse sein.
archive_member_too_large Ein Archiveintrag darf höchstens 100 MiB groß sein.
archive_member_path_duplicate Jeder Pfad im Archiv muss eindeutig sein.
archive_member_path_type_conflict Ein Dateipfad darf nicht zugleich ein Verzeichnis bezeichnen. Unter einem Dateipfad darf kein weiterer Archiveintrag liegen.
archive_too_many_entries Das Archiv darf höchstens 5.000 Einträge enthalten.
archive_uncompressed_too_large Das entpackte Archiv darf höchstens 512 MiB groß sein.
archive_member_unreadable Jeder Archiveintrag muss lesbar und unverschlüsselt sein und ein unterstütztes Komprimierungsverfahren verwenden.

Fehler im Stammverzeichnis des Plugins

Name Anforderung
plugin_root_missing Der ausgewählte Pfad muss vorhanden sein und auf ein Verzeichnis zeigen, das ein Plugin enthält.
archive_plugin_files_missing Das ZIP-Archiv muss ein unterstütztes Plugin-Manifest und mindestens einen gültigen Skill (oder einen genehmigten lokalen MCP-Server) enthalten.
plugin_root_ambiguous Das ZIP-Archiv muss genau ein Plugin-Stammverzeichnis enthalten. Es muss entweder das Stammverzeichnis des Archivs oder ein einzelnes Verzeichnis auf der obersten Ebene sein.
plugin_root_has_siblings Liegt das Plugin in einem Verzeichnis auf der obersten Ebene des ZIP-Archivs, dürfen auf derselben Ebene keine Dateien liegen.

Fehler im Plugin-Manifest

Name Anforderung
plugin_manifest_missing Das ZIP-Archiv muss im Stammverzeichnis oder in seinem einzigen Verzeichnis auf der obersten Ebene eines der folgenden Manifeste enthalten: plugin.json mit einem unterstützten Schema für Agent Plugins, .codex-plugin/plugin.json, .agent-plugin/plugin.json oder .claude-plugin/plugin.json.
plugin_manifest_not_file Das Plugin-Manifest muss eine reguläre JSON-Datei sein.
plugin_manifest_unreadable Das Plugin-Manifest muss als UTF-8-Text lesbar sein.
plugin_manifest_json_malformed Das Plugin-Manifest muss gültiges JSON enthalten. Bei einem Syntaxfehler gibt die Meldung die Zeilennummer an.
plugin_manifest_root_not_object Das Plugin-Manifest muss auf der obersten Ebene ein JSON-Objekt enthalten.
codex_manifest_parent_not_directory .codex-plugin muss ein Verzeichnis sein.
codex_manifest_path_not_file .codex-plugin/plugin.json muss eine reguläre JSON-Datei sein.
plugin_id_wrong_type Falls angegeben, muss id eine Zeichenfolge sein.
plugin_id_empty Falls angegeben, darf id nicht leer sein.
plugin_name_missing name ist erforderlich.
plugin_name_wrong_type name muss eine Zeichenfolge sein.
plugin_name_empty name darf nicht leer sein.
plugin_name_too_long name darf höchstens 64 Zeichen lang sein.
plugin_name_format name muss mit einem ASCII-Buchstaben oder einer ASCII-Ziffer beginnen und darf nur ASCII-Buchstaben, ASCII-Ziffern, _ oder - enthalten.
plugin_version_missing version ist erforderlich.
plugin_version_wrong_type version muss eine Zeichenfolge sein.
plugin_version_empty version muss eine nicht leere Zeichenfolge mit einer semantischen Versionsnummer sein, etwa 1.0.0.
plugin_version_not_semver version muss der semantischen Versionierung entsprechen, etwa 1.0.0.
plugin_version_too_long version darf höchstens 64 Zeichen lang sein.
plugin_description_missing description ist erforderlich.
plugin_description_wrong_type description muss eine Zeichenfolge sein.
plugin_description_empty description darf nicht leer sein.
plugin_description_too_long description darf höchstens 1.024 Zeichen lang sein.
plugin_description_character_unsupported description darf nur unterstützte Zeichen enthalten. Zeilenumbrüche sind zulässig.
plugin_developer_missing author.name ist erforderlich. interface.developerName ist ebenfalls erforderlich. Ein fehlender Wert wird separat gemeldet.
plugin_author_wrong_type author muss ein Objekt sein.
plugin_author_name_wrong_type author.name muss eine Zeichenfolge sein.
plugin_author_name_empty author.name darf nicht leer sein.
plugin_author_name_too_long author.name darf höchstens 120 Zeichen lang sein.
plugin_author_name_character_unsupported author.name darf nur unterstützte Zeichen enthalten.
plugin_author_email_wrong_type Falls angegeben, muss author.email eine Zeichenfolge sein.
plugin_author_email_empty Falls angegeben, darf author.email nicht leer sein.
plugin_author_email_too_long author.email darf höchstens 320 Zeichen lang sein.
plugin_author_email_character_unsupported author.email darf nur unterstützte Zeichen enthalten.
plugin_author_url_wrong_type Falls angegeben, muss author.url eine Zeichenfolge sein.
plugin_author_url_empty Falls angegeben, darf author.url nicht leer sein.
plugin_author_url_not_https author.url muss eine HTTPS-URL sein.
plugin_author_url_has_credentials author.url darf keine Zugangsdaten enthalten.
plugin_author_url_too_long author.url darf höchstens 2.048 Zeichen lang sein.
plugin_author_url_character_unsupported author.url darf nur unterstützte Zeichen enthalten.

Fehler im Verzeichniseintrag und in der Oberfläche

Das Objekt interface im Plugin-Manifest legt fest, wie der öffentliche Verzeichniseintrag angezeigt wird. Es steht in .codex-plugin/plugin.json und enthält Felder wie displayName und shortDescription:

{
  "interface": {
    "displayName": "Example Plugin",
    "shortDescription": "Summarize documents",
    "longDescription": "Summarize and organize documents.",
    "developerName": "Example",
    "category": "Productivity",
    "capabilities": ["Summarize documents"]
  }
}

Die vier URLs des Verzeichniseintrags (Website, Datenschutzrichtlinie, Nutzungsbedingungen und Support) sind bei ZIP-Uploads für reine Skill-Plugins optional. Bei der Einreichung von Remote-MCP-Servern sind sie erforderlich. Bei der Paketprüfung darf jede URL höchstens 2.048 Zeichen lang sein, bei der endgültigen Einreichung für das Verzeichnis höchstens 1.024 Zeichen.

Name Anforderung
plugin_interface_wrong_type Das Feld interface im Plugin-Manifest muss ein JSON-Objekt sein.
plugin_display_name_wrong_type interface.displayName muss eine Zeichenfolge sein.
plugin_display_name_empty interface.displayName ist erforderlich und darf nicht leer sein.
plugin_display_name_too_long interface.displayName darf bei der Paketprüfung höchstens 80 Zeichen lang sein, bei der endgültigen Einreichung für das Verzeichnis höchstens 30.
plugin_display_name_character_unsupported interface.displayName darf nur unterstützte Zeichen enthalten.
plugin_short_description_missing interface.shortDescription ist erforderlich und muss in eine Zeile passen. Bei der Paketprüfung sind höchstens 240 Zeichen zulässig, bei der endgültigen Einreichung für das Verzeichnis höchstens 30.
plugin_short_description_wrong_type interface.shortDescription muss eine Zeichenfolge sein.
plugin_short_description_empty interface.shortDescription darf nicht leer sein.
plugin_short_description_too_long interface.shortDescription darf bei der Paketprüfung höchstens 240 Zeichen lang sein, bei der endgültigen Einreichung für das Verzeichnis höchstens 30.
plugin_short_description_character_unsupported interface.shortDescription darf nur unterstützte Zeichen enthalten.
plugin_long_description_wrong_type interface.longDescription muss eine Zeichenfolge sein.
plugin_long_description_empty interface.longDescription ist erforderlich und darf nicht leer sein.
plugin_long_description_too_long interface.longDescription darf höchstens 4.000 Zeichen lang sein.
plugin_long_description_character_unsupported interface.longDescription darf nur unterstützte Zeichen enthalten. Zeilenumbrüche sind zulässig.
plugin_developer_name_wrong_type interface.developerName muss eine Zeichenfolge sein.
plugin_developer_name_empty interface.developerName ist erforderlich und darf nicht leer sein.
plugin_developer_name_too_long interface.developerName darf bei der Paketprüfung höchstens 120 Zeichen lang sein, bei der endgültigen Einreichung für das Verzeichnis höchstens 80.
plugin_developer_name_character_unsupported interface.developerName darf nur unterstützte Zeichen enthalten.
plugin_category_wrong_type interface.category muss eine Zeichenfolge sein.
plugin_category_empty Falls angegeben, darf interface.category nicht leer sein. Lass das Feld weg, um Other zu verwenden.
plugin_category_unknown interface.category muss einen der folgenden Werte haben: Productivity, Creativity, Developer Tools, Business & Operations, Data & Analytics, Communication, Education & Research, Security, Finance, Healthcare, Travel, Entertainment oder Other.
plugin_category_character_unsupported interface.category darf nur unterstützte Zeichen enthalten.
plugin_capabilities_wrong_type interface.capabilities muss eine Liste von Zeichenfolgen sein.
plugin_capabilities_too_many interface.capabilities darf höchstens 20 Einträge enthalten.
plugin_capability_wrong_type Jeder Eintrag in interface.capabilities muss eine Zeichenfolge sein.
plugin_capability_empty Kein angegebener Eintrag in interface.capabilities darf leer sein.
plugin_capability_too_long Jeder Eintrag in interface.capabilities darf höchstens 120 Zeichen lang sein.
plugin_capability_character_unsupported Jeder Eintrag in interface.capabilities darf nur unterstützte Zeichen enthalten.
plugin_website_url_wrong_type Falls angegeben, muss interface.websiteURL eine Zeichenfolge sein.
plugin_website_url_empty Falls angegeben, darf interface.websiteURL nicht leer sein.
plugin_website_url_format interface.websiteURL muss eine HTTPS-URL sein.
plugin_website_url_too_long Für interface.websiteURL gelten die Längenbeschränkungen für URLs im Verzeichniseintrag.
plugin_privacy_policy_url_wrong_type Falls angegeben, muss interface.privacyPolicyURL eine Zeichenfolge sein.
plugin_privacy_policy_url_empty Falls angegeben, darf interface.privacyPolicyURL nicht leer sein.
plugin_privacy_policy_url_format interface.privacyPolicyURL muss eine HTTPS-URL sein.
plugin_privacy_policy_url_too_long Für interface.privacyPolicyURL gelten die Längenbeschränkungen für URLs im Verzeichniseintrag.
plugin_terms_of_service_url_wrong_type Falls angegeben, muss interface.termsOfServiceURL eine Zeichenfolge sein.
plugin_terms_of_service_url_empty Falls angegeben, darf interface.termsOfServiceURL nicht leer sein.
plugin_terms_of_service_url_format interface.termsOfServiceURL muss eine HTTPS-URL sein.
plugin_terms_of_service_url_too_long Für interface.termsOfServiceURL gelten die Längenbeschränkungen für URLs im Verzeichniseintrag.
plugin_support_url_wrong_type Falls angegeben, muss interface.supportURL eine Zeichenfolge sein.
plugin_support_url_empty Falls angegeben, darf interface.supportURL nicht leer sein.
plugin_support_url_format interface.supportURL muss eine HTTPS-URL sein.
plugin_support_url_too_long Für interface.supportURL gelten die Längenbeschränkungen für URLs im Verzeichniseintrag.
plugin_homepage_wrong_type Falls angegeben, muss homepage eine Zeichenfolge sein.
plugin_homepage_empty Falls angegeben, darf homepage nicht leer sein.
plugin_homepage_format homepage muss eine HTTPS-URL sein.
plugin_homepage_too_long homepage darf höchstens 2.048 Zeichen lang sein.
plugin_brand_color_wrong_type Falls angegeben, muss interface.brandColor eine Zeichenfolge sein.
plugin_brand_color_empty Falls angegeben, darf interface.brandColor nicht leer sein.
plugin_brand_color_format interface.brandColor muss ein sechsstelliger Hex-Farbcode sein, etwa #1ABCFE.
plugin_brand_color_dark_wrong_type Falls angegeben, muss interface.brandColorDark eine Zeichenfolge sein.
plugin_brand_color_dark_empty Falls angegeben, darf interface.brandColorDark nicht leer sein.
plugin_brand_color_dark_format interface.brandColorDark muss ein sechsstelliger Hex-Farbcode sein, etwa #1ABCFE.
plugin_brand_color_contrast interface.brandColor muss zu Weiß ein Kontrastverhältnis von mindestens 2:1 aufweisen.
plugin_brand_color_dark_contrast interface.brandColorDark muss zu #212121 ein Kontrastverhältnis von mindestens 2:1 aufweisen.
plugin_default_prompt_wrong_type interface.defaultPrompt muss eine Zeichenfolge oder eine Liste von Zeichenfolgen sein.
plugin_default_prompt_too_many interface.defaultPrompt darf höchstens drei Prompts enthalten.
plugin_default_prompt_entry_wrong_type Jeder Eintrag in interface.defaultPrompt muss eine Zeichenfolge sein.
plugin_default_prompt_empty Kein angegebener Eintrag in interface.defaultPrompt darf leer sein.
plugin_default_prompt_too_long Jeder Eintrag in interface.defaultPrompt darf bei der Paketprüfung höchstens 512 Zeichen lang sein, bei der endgültigen Einreichung für das Verzeichnis höchstens 128.
plugin_default_prompt_character_unsupported Jeder Eintrag in interface.defaultPrompt darf nur unterstützte Zeichen enthalten und muss in eine Zeile passen.

Fehler im Plugin-Inhalt

Name Anforderung
plugin_skills_path_wrong_type skills muss den Pfad zum Verzeichnis skills/ im Stammverzeichnis als Zeichenfolge angeben.
plugin_skills_path_empty Falls angegeben, muss skills einen nicht leeren Pfad zum Verzeichnis skills/ im Stammverzeichnis enthalten.
plugin_skills_path_unsupported skills muss auf das Verzeichnis skills/ im Stammverzeichnis verweisen.
plugin_skills_directory_missing Wenn skills/ deklariert ist, muss das Verzeichnis im Stammverzeichnis vorhanden sein.
plugin_skills_path_not_directory Wenn skills/ deklariert ist, muss der Eintrag im Stammverzeichnis ein Verzeichnis sein.
plugin_apps_path_wrong_type apps muss den Pfad zur Datei .app.json im Stammverzeichnis als Zeichenfolge angeben.
plugin_apps_path_empty Falls angegeben, muss apps einen nicht leeren Pfad zur Datei .app.json im Stammverzeichnis enthalten.
plugin_apps_path_unsupported apps muss auf die Datei .app.json im Stammverzeichnis verweisen.
plugin_apps_file_missing Wenn .app.json deklariert ist, muss die Datei im Stammverzeichnis vorhanden sein.
plugin_apps_path_not_file Wenn .app.json deklariert ist, muss der Eintrag im Stammverzeichnis eine reguläre Datei sein.
plugin_mcp_path_wrong_type mcpServers muss den Pfad zur Datei .mcp.json im Stammverzeichnis als Zeichenfolge angeben.
plugin_mcp_path_empty mcpServers muss einen nicht leeren Pfad enthalten. Setze den Wert auf ./.mcp.json oder entferne das Feld.
plugin_mcp_path_unsupported mcpServers muss auf die Datei .mcp.json im Stammverzeichnis verweisen.
plugin_mcp_file_missing mcpServers verweist auf .mcp.json im Stammverzeichnis, aber die Datei fehlt.
plugin_mcp_path_not_file .mcp.json im Stammverzeichnis muss eine reguläre Datei sein.
plugin_runtime_surface_missing Ein ZIP-Archiv für die Einreichung im öffentlichen Verzeichnis muss mindestens einen gültigen Skill (oder einen genehmigten lokalen MCP-Server) enthalten. Lokale Pakete und Workspace-Pakete können auch auf einen zulässigen MCP-Server verweisen.

Fehler im MCP-Manifest

Diese Fehler betreffen die Kompatibilitätsdatei .mcp.json. Bei portablen Paketen erzeugt der Import diese Datei und .codex-plugin/plugin.json aus den Dateien plugin.json und mcp.json im Stammverzeichnis. Die oben aufgeführten Fehler bei Komponentenpfaden können sich auch auf diese generierten Dateien beziehen. Korrigiere die ursprüngliche portable Konfiguration. Benenne mcp.json nicht allein deshalb in .mcp.json um, weil eine Diagnose zur Kompatibilität diese Datei nennt.

Name Anforderung
mcp_manifest_unreadable .mcp.json muss als UTF-8-Text lesbar sein.
mcp_manifest_json_malformed .mcp.json muss gültiges JSON enthalten. Bei einem Syntaxfehler gibt die Meldung die Zeilennummer an.
mcp_manifest_wrong_type .mcp.json muss auf der obersten Ebene ein JSON-Objekt enthalten.
mcp_servers_missing .mcp.json muss auf der obersten Ebene das Feld mcpServers enthalten.
mcp_servers_wrong_type mcpServers muss ein Objekt sein.
mcp_server_name_empty Jeder MCP-Servername muss mindestens ein Zeichen enthalten, das kein Leerraumzeichen ist.
mcp_server_wrong_type Jeder Wert unter mcpServers.<server-name> muss ein Objekt mit der Deklaration des jeweiligen Servers sein.

Skill-Fehler

Name Anforderung
skill_manifest_missing Der Skill muss eine Datei namens SKILL.md enthalten.
skill_bundle_too_large Jedes komprimierte Skill-Paket muss den in der Fehlermeldung angegebenen Grenzwert in MiB einhalten.
skill_directory_hidden Der Name eines Skill-Verzeichnisses darf nicht mit . beginnen.
skill_manifest_nested Jedes Skill-Verzeichnis muss direkt unter skills/ liegen.
skill_manifest_not_regular_file SKILL.md muss eine reguläre Datei sein.
skill_manifest_unreadable SKILL.md muss lesbar sein.
skill_manifest_invalid_utf8 SKILL.md muss gültigen UTF-8-Text enthalten.
skill_frontmatter_missing SKILL.md muss mit einem YAML-Frontmatter-Block beginnen, den zwei Zeilen mit --- begrenzen.
skill_frontmatter_unclosed Der YAML-Frontmatter-Block in SKILL.md muss mit --- enden.
skill_frontmatter_yaml_malformed Der Frontmatter-Block in SKILL.md muss gültiges YAML enthalten.
skill_frontmatter_wrong_type Der Frontmatter-Block in SKILL.md muss ein YAML-Mapping enthalten.
skill_name_missing name ist erforderlich und darf nicht leer sein.
skill_name_wrong_type name muss eine Zeichenfolge sein.
skill_name_empty name darf nicht leer sein.
skill_name_character_unsupported Das Feld name im Frontmatter des Skills darf nur unterstützte Zeichen enthalten.
skill_description_missing description ist erforderlich und darf nicht leer sein.
skill_description_wrong_type description muss eine Zeichenfolge sein.
skill_description_empty description darf nicht leer sein.
skill_description_too_long description darf höchstens 1.024 Zeichen lang sein.
skill_description_character_unsupported Das Feld description im Frontmatter des Skills darf nur unterstützte Zeichen enthalten.
skill_body_empty Die Skill-Anweisungen dürfen nicht leer sein.
skill_identity_too_long Der kombinierte Name aus Plugin und Skill (plugin-name:skill-name) darf höchstens 64 Zeichen lang sein.
skill_identity_duplicate Der Wert von name muss für jeden Skill innerhalb des Plugins eindeutig sein.

Fehler in den Agentenmetadaten eines Skills

Ein mitgelieferter Skill kann ein eigenes interface in skills/<skill>/agents/openai.yaml definieren. Dieses Objekt legt fest, wie der Skill angezeigt wird, und ist vom Objekt interface im Plugin-Manifest unabhängig. Die Feldnamen für die Skill-Oberfläche verwenden snake_case:

interface:
  display_name: "Summarize documents"
  short_description: "Summarize a document"
  icon_small: "./assets/icon.png"
  default_prompt: "Summarize the selected document."
Name Anforderung
skill_agent_not_regular_file agents/openai.yaml muss eine reguläre Datei sein.
skill_agent_unreadable agents/openai.yaml muss lesbar sein.
skill_agent_invalid_utf8 agents/openai.yaml muss gültigen UTF-8-Text enthalten.
skill_agent_yaml_malformed agents/openai.yaml muss gültiges YAML enthalten.
skill_agent_top_level_wrong_type agents/openai.yaml muss auf der obersten Ebene ein YAML-Mapping enthalten.
skill_agent_interface_missing Das Feld interface ist in agents/openai.yaml erforderlich, wenn das Paket diese Datei enthält.
skill_agent_interface_wrong_type interface muss in agents/openai.yaml ein YAML-Mapping sein.
skill_agent_display_name_missing interface.display_name ist erforderlich und darf nicht leer sein.
skill_agent_display_name_wrong_type interface.display_name muss eine Zeichenfolge sein.
skill_agent_display_name_empty interface.display_name darf nicht leer sein.
skill_agent_short_description_missing interface.short_description ist erforderlich und darf nicht leer sein.
skill_agent_short_description_wrong_type interface.short_description muss eine Zeichenfolge sein.
skill_agent_short_description_empty interface.short_description darf nicht leer sein.
skill_agent_icon_small_wrong_type Falls angegeben, muss interface.icon_small ein nicht leerer relativer Dateipfad sein.
skill_agent_icon_small_empty Falls angegeben, muss interface.icon_small ein nicht leerer relativer Dateipfad sein, etwa assets/icon.png.
skill_agent_icon_large_wrong_type Falls angegeben, muss interface.icon_large ein nicht leerer relativer Dateipfad sein.
skill_agent_icon_large_empty Falls angegeben, muss interface.icon_large ein nicht leerer relativer Dateipfad sein, etwa assets/icon.png.
skill_agent_brand_color_wrong_type Falls angegeben, muss interface.brand_color eine Zeichenfolge sein.
skill_agent_brand_color_empty Falls angegeben, muss interface.brand_color einen nicht leeren sechsstelligen Hex-Farbcode enthalten, etwa #1ABCFE.
skill_agent_brand_color_format interface.brand_color muss ein sechsstelliger Hex-Farbcode sein, etwa #1ABCFE.
skill_agent_default_prompt_wrong_type Falls angegeben, muss interface.default_prompt eine Zeichenfolge sein.
skill_agent_default_prompt_empty Falls angegeben, darf interface.default_prompt nicht leer sein.
skill_agent_policy_wrong_type Falls angegeben, muss policy ein YAML-Mapping sein.
skill_agent_allow_implicit_invocation_wrong_type policy darf nur products und allow_implicit_invocation enthalten. products muss CHAT, CODEX oder beide Werte enthalten. allow_implicit_invocation muss true oder false sein.
skill_agent_dependencies_wrong_type dependencies muss ein YAML-Mapping sein. Als Schlüssel wird nur tools unterstützt.
skill_agent_dependency_unsupported Nur dependencies.tools wird in agents/openai.yaml unterstützt.

Fehler bei Asset-Pfaden

Name Anforderung
declared_asset_path_wrong_type Das in der Meldung genannte Asset-Feld muss einen Dateipfad als Zeichenfolge enthalten.
declared_asset_path_empty Das genannte Asset-Feld darf nicht leer sein.
declared_asset_path_has_outer_whitespace Der Wert im genannten Asset-Feld darf weder mit Leerraum beginnen noch mit Leerraum enden.
declared_asset_path_has_control_character Das genannte Asset-Feld darf weder Zeichen im Bereich U+0000–U+001F noch das Zeichen U+007F enthalten.
branding_asset_path_missing_root_prefix Der Wert im genannten Asset-Feld muss mit ./ beginnen.
declared_asset_path_unsafe Das genannte Asset-Feld muss einen relativen Pfad innerhalb des Plugins enthalten. Absolute Pfade, Laufwerkspräfixe und ..-Segmente für den Wechsel ins übergeordnete Verzeichnis sind unzulässig.
declared_asset_path_outside_package Das genannte Asset-Feld muss auf eine Datei innerhalb des Plugins verweisen.
declared_asset_file_missing Das genannte Asset-Feld verweist auf eine Datei, die nicht vorhanden ist.
declared_asset_not_regular_file Das genannte Asset-Feld muss auf eine reguläre Datei verweisen. Verzeichnisse und Spezialdateien sind unzulässig.

Bildfehler

Markenbilder für das Verzeichnis müssen ein unterstütztes Dateiformat verwenden und die folgenden Grenzwerte für Dateigröße und Bildabmessungen einhalten. Diese Regeln gelten für Markenbilder im Paket.

Name Anforderung
plugin_logo_path_missing interface.logo ist erforderlich und muss auf ein quadratisches Bild verweisen.
plugin_composer_icon_path_missing interface.composerIcon ist erforderlich und muss auf ein quadratisches Bild verweisen.
image_file_unreadable Die Bilddatei muss lesbar sein.
image_file_too_large Das Bild darf höchstens 5 MiB groß sein.
image_file_format_unsupported Der Bilddateiname muss auf .png, .jpg, .jpeg, .webp oder .svg enden.
raster_image_decode_failed Das Rasterbild muss eine PNG-, JPEG- oder WebP-Datei sein, die sich sicher dekodieren lässt.
raster_image_extension_content_mismatch Die Dateiendung muss zum erkannten Bildformat passen.
raster_image_not_square Das Bild muss quadratisch sein.
raster_image_dimensions_too_small Das Bild muss mindestens 48 × 48 Pixel groß sein.
raster_image_dimensions_too_large Das Bild darf höchstens 4.096 × 4.096 Pixel groß sein.
svg_xml_malformed Die SVG-Datei muss gültiges XML in UTF-8 enthalten.
svg_root_element_invalid Das Wurzelelement der SVG-Datei muss <svg> sein.
svg_dimensions_missing Die SVG-Datei muss numerische Werte für viewBox oder für width und height angeben.
svg_dimensions_not_numeric Die SVG-Abmessungen müssen numerisch sein. Einheiten und Prozentangaben sind unzulässig.
svg_dimensions_not_positive Breite und Höhe der SVG-Grafik müssen positive, endliche Zahlen sein.
svg_dimensions_not_square Breite und Höhe der SVG-Grafik müssen gleich sein.
svg_dimensions_too_small Die SVG-Grafik muss mindestens 48 × 48 Pixel groß sein.

Fehler bei Verweisen auf MCP-Server

Wenn ein Plugin auf registrierte MCP-Server verweist, wird .app.json bei der allgemeinen Paketprüfung validiert. Das Einreichungsportal veröffentlicht keine Verweise auf bestehende Integrationen. Beim Upload über Nur Skills entfernt das Portal .app.json. Reiche den MCP-Server über Mit MCP direkt ein.

Bei lokalen Paketen und Workspace-Paketen ordnet das Objekt apps auf der obersten Ebene jedem MCP-Serveralias einen registrierten Servereintrag zu. In diesen Konfigurationsnamen und Fehlercodes bleibt die Schreibweise app erhalten.

Name Anforderung
app_manifest_unreadable .app.json muss als UTF-8-Text lesbar sein.
app_manifest_json_malformed .app.json enthält in der Nähe der angegebenen Zeile fehlerhaftes JSON.
app_manifest_wrong_type .app.json muss auf der obersten Ebene ein JSON-Objekt enthalten.
app_entries_missing apps ist erforderlich.
app_entries_wrong_type apps muss ein Objekt sein.
app_entry_wrong_type Jeder Servereintrag muss ein Objekt sein.
app_id_missing Jeder Servereintrag muss eine id enthalten.
app_id_wrong_type Die id jedes Servereintrags muss eine Zeichenfolge sein.
app_id_format Die id jedes Servereintrags muss mit asdk_app_, connector_ oder templated_apps_ beginnen. Direkt darauf muss ein Buchstabe oder eine Ziffer folgen. Danach sind nur Buchstaben, Ziffern, _ oder - zulässig.
app_entry_optional_wrong_type Falls im Servereintrag angegeben, muss optional den Wert true oder false haben.
app_entry_required_wrong_type Falls im Servereintrag angegeben, muss required den Wert true oder false haben.
app_not_eligible Ein lokales Paket oder Workspace-Paket muss auf einen zulässigen, verfügbaren MCP-Server verweisen. Reiche den MCP-Server für das Verzeichnis direkt über Mit MCP ein.

Paketwarnungen

Diese Warnungen zeigen an, welche Paketinhalte die Validierung ignoriert oder normalisiert. Sie verhindern die Einreichung nicht. Prüfe anhand der Warnungen, ob das eingereichte Plugin die erwarteten Dateien und Einstellungen enthält.

Name Anforderung
duplicate_app_reference Auf jede Server-ID in .app.json darf nur einmal verwiesen werden. Mehrere Verweise auf dieselbe ID zählen als ein Server.
undeclared_app_manifest_ignored Die Datei .app.json im Stammverzeichnis wird nur importiert, wenn das Feld apps im Plugin-Manifest auf ./.app.json gesetzt ist.
undeclared_mcp_manifest_ignored Die Datei .mcp.json im Stammverzeichnis wird nur importiert, wenn das Feld mcpServers im Plugin-Manifest auf ./.mcp.json gesetzt ist.
skill_file_ignored Dateien direkt unter skills/ werden nicht als Skills importiert. Jeder Skill muss in einem Verzeichnis liegen, das SKILL.md enthält.
skill_symlink_ignored Symbolische Links direkt unter skills/ werden nicht als Skills importiert. Jeder Skill muss in einem tatsächlichen Verzeichnis liegen, das SKILL.md enthält.
skill_frontmatter_adjusted Beim Import werden die Skill-Felder name und description normalisiert. Führende und nachgestellte Leerraumzeichen werden entfernt, aufeinanderfolgende Leerraumzeichen innerhalb des Werts zu einem einzelnen Leerzeichen zusammengefasst.
skill_metadata_ignored Lege die Einstellungen für die Skill-Oberfläche im Mapping interface in agents/openai.yaml fest. Das Feld metadata in SKILL.md konfiguriert die Oberfläche nicht.

Nächste Schritte

Wenn du alle Validierungsfehler behoben hast, kehre zur Anleitung Plugins einreichen zurück, um die Einreichung abzuschließen.