From cd9804305c1d7f43e4201a612bea93738a928045 Mon Sep 17 00:00:00 2001
From: Viktorplus <36795799+viktorplus@users.noreply.github.com>
Date: Sun, 7 Jun 2026 23:09:09 +0200
Subject: [PATCH] docs: clarify Kimi config root discovery

---
 docs/how-to/install-on-your-runtime.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/docs/how-to/install-on-your-runtime.md b/docs/how-to/install-on-your-runtime.md
index d7229890b..e82b342aa 100644
--- a/docs/how-to/install-on-your-runtime.md
+++ b/docs/how-to/install-on-your-runtime.md
@@ -191,18 +191,14 @@ Then launch the generated agent from that directory:
 kimi --agent-file ~/.kimi-code/agents/gsd.yaml
 ```
 
-**Override the install directory:**
-
-```bash
-KIMI_CONFIG_DIR=~/.agents-alt npx @opengsd/gsd-core@latest --kimi --global
-```
-
 For brand-specific scripted installs, use:
 
 ```bash
 KIMI_CONFIG_DIR=~/.kimi-code npx @opengsd/gsd-core@latest --kimi --global
 ```
 
+Avoid arbitrary `KIMI_CONFIG_DIR` roots unless your Kimi configuration also adds the matching `skills/` directory to Kimi's extra skill directories. GSD can write files there, but Kimi will not auto-discover skills outside its documented generic and brand-specific roots without that Kimi-side configuration.
+
 `--kimi --local` is intentionally deferred and guarded in v1; use the global install path above for Kimi CLI.
 
 ---