The Codex manifest carries a version, interface metadata and an icon

.codex-plugin/plugin.json

@@ -1,5 +1,6 @@
 {
   "name": "plugin-stack",
+  "version": "1.0.0",
   "description": "Skills for AI plugin builders: optimize listings, submit to stores, audit discoverability, design widgets and watch competitors, on live data from OpenApps",
   "author": {
     "name": "The Open Apps, Inc.",
@@ -8,5 +9,12 @@
   "homepage": "https://theopenapps.com?ref=plugin-stack",
   "repository": "https://github.com/theopenapps/plugin-stack",
   "license": "MIT",
-  "skills": "./skills/"
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Plugin Stack",
+    "shortDescription": "Optimize listings, submit to stores, audit discoverability, design widgets and watch competitors",
+    "developerName": "The Open Apps, Inc.",
+    "websiteURL": "https://theopenapps.com?ref=plugin-stack",
+    "composerIcon": "./assets/icon.svg"
+  }
 }

scripts/check-skills.mjs

@@ -79,9 +79,9 @@ for (const skill of skills) {
 if (licenses.size > 1) fail("LICENSE.txt", `differs across skills: ${[...licenses.values()].map((s) => s.join(", ")).join(" | ")}`);
 
 // Claude Code holds back an update until the version changes. With no version, every commit on main is an update.
-for (const manifest of [".claude-plugin/plugin.json", ".codex-plugin/plugin.json"]) {
-  if ("version" in JSON.parse(readFileSync(manifest, "utf8"))) fail(manifest, "has a version");
-}
+if ("version" in JSON.parse(readFileSync(".claude-plugin/plugin.json", "utf8"))) fail(".claude-plugin/plugin.json", "has a version");
+// Codex updates whatever the version says, and the HOL list requires one, so its manifest keeps a fixed one.
+if (JSON.parse(readFileSync(".codex-plugin/plugin.json", "utf8")).version !== "1.0.0") fail(".codex-plugin/plugin.json", "version is not 1.0.0");
 
 if (errors.length) {
   console.error(errors.join("\n"));