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,openWorldHintunddestructiveHintbei 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.