Small fixes (VScode install link, skill.sh schema not available, ..) (#5)

* remove skills.sh schema, it does not exist under that location

* add readme to .agents to explain it's the openai codex plugin

* vscode install link as HTML (hoping that it renders that way on GH)

* give up, GH does not render VScode install links

* fix build

---------

Co-authored-by: Fady Fawzy <fady.fawzy@commercetools.com>

Author: nkuehn

.agents/README.md

@@ -0,0 +1,3 @@
+This folder contains the OpenAI Codex plugin until https://github.com/openai/codex/issues/17066 is resolved.  It holds a full copy of the skills. 
+
+Only after that issue is resolved we can move to the conventional `.codex-plugin` and have it use the repo root `skills` folder. 

.internal/scripts/build.mjs

@@ -247,7 +247,8 @@ const discoverSkillSlugs = () => {
 };
 
 const skillsShConfig = {
-  $schema: "https://skills.sh/schemas/skills.sh.schema.json",
+  // schema is broken 404 at the moment .. uncomment when its working again
+  // $schema: "https://skills.sh/schemas/skills.sh.schema.json",
   groupings: [
     {
       title: "commercetools-skills",

README.md

@@ -32,7 +32,7 @@ The official commercetools Plugins gives **Claude Code**, **Cursor**, **VS Code
 | Tool | Command |
 | :--- | :--- |
 | **All tools: Skills-only installation** | Terminal: `npx skills add commercetools/commercetools-ai-plugins` <br/> Does not auto-update and lacks agents. Run `npx skills update` regularly to update. |
-| **VS Code: Knowledge MCP only** | [Click here to install](vscode:mcp/install?%7B%22name%22%3A%22commercetools-knowledge%22%2C%22transport%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.commercetools.com%2Fapis%2Fmcp%22%7D) |
+| **Knowledge MCP only** | [See its documentation for installation instructions](https://docs.commercetools.com/sdk/mcp/knowledge-mcp) |
 
 
 ## Why this exists

skills.sh.json

@@ -1,5 +1,4 @@
 {
-  "$schema": "https://skills.sh/schemas/skills.sh.schema.json",
   "groupings": [
     {
       "title": "commercetools-skills",