From e815f0d05c0bce41d1f19f57fe27c21de2292c2b Mon Sep 17 00:00:00 2001
From: Affaan Mustafa <affaan@dcube.ai>
Date: Sat, 28 Mar 2026 20:23:34 -0400
Subject: [PATCH] fix(docs): resolve skill guide review issues

---
 docs/SKILL-DEVELOPMENT-GUIDE.md | 15 ++++++++++++---
 rules/zh/README.md              |  4 ++--
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/docs/SKILL-DEVELOPMENT-GUIDE.md b/docs/SKILL-DEVELOPMENT-GUIDE.md
index a772c868..cbf5e3c8 100644
--- a/docs/SKILL-DEVELOPMENT-GUIDE.md
+++ b/docs/SKILL-DEVELOPMENT-GUIDE.md
@@ -606,14 +606,23 @@ description: Quick reference for [API/Library].
 Test all code examples:
 
 ```bash
-# For TypeScript (run from inside the skill directory or specify the path)
+# From the repo root
 npx tsc --noEmit skills/your-skill-name/examples/*.ts
 
-# For Python
+# Or from inside the skill directory
+npx tsc --noEmit examples/*.ts
+
+# From the repo root
 python -m py_compile skills/your-skill-name/examples/*.py
 
-# For Go
+# Or from inside the skill directory
+python -m py_compile examples/*.py
+
+# From the repo root
 go build ./skills/your-skill-name/examples/...
+
+# Or from inside the skill directory
+go build ./examples/...
 ```
 
 ---
diff --git a/rules/zh/README.md b/rules/zh/README.md
index 34f71910..35baaf64 100644
--- a/rules/zh/README.md
+++ b/rules/zh/README.md
@@ -103,6 +103,6 @@ cp -r rules/php ~/.claude/rules/php
 
 ### 带覆盖说明的通用规则
 
-`rules/common/` 中可能被语言特定文件覆盖的规则会标记：
+`rules/common/` 中可能被语言特定文件覆盖的规则会被标记：
 
-> **语言说明**：此规则可能被语言特定规则覆盖，对于某些语言，该模式可能不是惯用的。
+> **语言说明**：此规则可能会被语言特定规则覆盖；对于某些语言，该模式可能并不符合惯用写法。