diff --git a/DOC_README.md b/DOC_README.md
index 93f6b3f16..8807a4001 100644
--- a/DOC_README.md
+++ b/DOC_README.md
@@ -158,9 +158,12 @@ Install them into whatever assistant you use, with one command:
 npx skills add https://github.com/melonjs/melonJS/tree/master/packages/melonjs/skills
 ```
 
-That writes each agent's own convention — `.claude/skills/`, `.agents/skills/`,
-`.windsurf/skills/` and around seventy others — so there is nothing to place by
-hand. It installs from `master`; swap that for a release tag in the URL to pin.
+It installs one copy of each skill under `.agents/skills/<skill-name>`, then
+symlinks that copy into every assistant's own directory, so
+`.claude/skills/melonjs` points back at `.agents/skills/melonjs` and there is
+nothing to place by hand. It reports the assistants it covers as it runs (77 of
+them at the time of writing). It installs from `master`; swap that for a release
+tag in the URL to pin.
 
 They are plain Markdown — readable by any agent, or by you.
 
diff --git a/README.md b/README.md
index 3fd33c5d0..47d2ee912 100644
--- a/README.md
+++ b/README.md
@@ -341,10 +341,12 @@ Install them into whatever assistant you use, with one command :
 npx skills add https://github.com/melonjs/melonJS/tree/master/packages/melonjs/skills
 ```
 
-It detects the assistants in your project and writes each one's own convention
-— `.claude/skills/`, `.agents/skills/`, `.windsurf/skills/` and around seventy
-others — so there is nothing to place by hand. Add `-a claude-code -a cursor`
-to target specific ones.
+It detects the assistants in your project and installs one copy of each skill
+under `.agents/skills/<skill-name>`, then symlinks that copy into every
+assistant's own directory, so `.claude/skills/melonjs` points back at
+`.agents/skills/melonjs` and there is nothing to place by hand. It reports the
+assistants it covers as it runs (77 of them at the time of writing). Add
+`-a claude-code -a cursor` to target specific ones.
 
 The set includes an `AGENTS.md` for anything following that convention (Codex,
 Cursor, Gemini CLI); GitHub Copilot reads the same content from