wxy · Mar 31, 2026 · Mar 31, 2026 · Mar 31, 2026
diff --git a/.agent/skills/_change-summary/SKILL.md b/.agent/skills/_change-summary/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _change-summary
+name: change-summary
 description: 自动汇总当前分支相对主分支的提交摘要，用于 PR/说明对齐。
 ---
 

diff --git a/.agent/skills/_code-health-check/SKILL.md b/.agent/skills/_code-health-check/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _code-health-check
+name: code-health-check
 description: Perform code quality checks before commit. Validates code standards, security, architectural consistency. Runs TypeScript compilation, linting, test coverage verification.
 ---
 

diff --git a/.agent/skills/_context-ack/SKILL.md b/.agent/skills/_context-ack/SKILL.md
@@ -1,6 +1,5 @@
-````skill
 ---
-name: _context-ack
+name: context-ack
 description: 在每次回复中使用固定前缀并列出本次实际参考的指令/文件，便于校验是否遵循上下文与规则。
 ---
 
@@ -144,6 +143,4 @@ description: 在每次回复中使用固定前缀并列出本次实际参考的
 □ 已启用技能中的每个技能，我都在正文中体现过吗？（至少一个关键步骤或结论）
 □ 如果某个技能只是"在上下文中存在"但未使用，我有删除它吗？
 □ 我能为清单中的每一项都举出具体证据吗？
-```
-
-````
+```
diff --git a/.agent/skills/_evolution-core/SKILL.md b/.agent/skills/_evolution-core/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _evolution-core
+name: evolution-core
 description: Evolution capability meta-skill. Identifies evolutionary scenarios (repeated errors, user feedback, complex workflows) and crystallizes experience into reusable skills or instruction updates.
 ---
 
@@ -59,9 +59,12 @@ When **
8000
Skill Failure** is triggered, the following remedial actions must be exec
 - [ ] Has post-verification been completed?
 
 ## 💡 Naming Conventions (Recommended)
-- **Project custom skills** should uniformly use the `_` prefix, e.g., `_evolution-core`.
-- Prefix is used to distinguish from official skills.
-- If categorization by domain is needed, unified prefix strategies like `_evo-`, `_proj-` can be used.
+- **Skill directories** should uniformly use the `_` prefix, e.g., `.agent/skills/_evolution-core/`.
+- The `_` directory prefix distinguishes evoskills from other skill sources and prevents directory name collisions.
+- The `name:` field in `SKILL.md` should **not** include `_`, e.g., `name: evolution-core`.
+  - This avoids VS Code validation errors (only lowercase letters, numbers, and hyphens are allowed in `name:`).
+  - Directory name and `name:` field intentionally differ — directory controls filesystem isolation, `name:` controls VS Code registration.
+- If categorization by domain is needed, subdirectory grouping or unified prefix strategies like `evo-`, `proj-` can be used in the `name:` field.
 
 ## 📝 Examples
 

diff --git a/.agent/skills/_execution-precheck/SKILL.md b/.agent/skills/_execution-precheck/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _execution-precheck
+name: execution-precheck
 description: 执行前检查清单。每次回复前必须自动进行的自我检查，确保没有遗漏强制规则。
 ---
 

diff --git a/.agent/skills/_file-output-guard/SKILL.md b/.agent/skills/_file-output-guard/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _file-output-guard
+name: file-output-guard
 description: 创建/输出文件的安全约束。禁止 HERE 文档创建文件；大文件输出需分段写入同一文件，避免会话超限。
 ---
 
@@ -31,9 +31,9 @@ description: 创建/输出文件的安全约束。禁止 HERE 文档创建文件
 2. **后续内容分段追加**：使用 `apply_patch` 将新段落追加到同一文件末尾。
 3. **每段写入后**提供简短确认，不在聊天中重复输出大段正文。
 4. **分段编号与续写标记**：
-  - 每段开头写明 `[Part X/Y]`（未知总数可用 `[Part X/?]`）。
-  - 续写时**删除上一段的分段标记**，并在文件末尾**追加新的分段标记与内容**。
-  - 续写时必须带上上一段的“最后一行”作为上下文锚点。
+   - 每段开头写明 `[Part X/Y]`（未知总数可用 `[Part X/?]`）。
+   - 续写时**删除上一段的分段标记**，并在文件末尾**追加新的分段标记与内容**。
+   - 续写时必须带上上一段的"最后一行"作为上下文锚点。
 
 ### 3) 分段写入操作示例
 **首次创建**：
@@ -51,8 +51,6 @@ create_file({
  既有末尾内容
 +[Part 2/?]
 +第二段内容...
-+第三段内容...
-+第三段内容...
 ```
 
 ## 检查清单
@@ -63,5 +61,5 @@ create_file({
 - [ ] 是否包含分段编号与续写标记？
 
 ## 与其他技能的关系
-- 与 `_context-ack` 配合：在“已启用技能”中标注该约束已生效。
+- 与 `_context-ack` 配合：在"已启用技能"中标注该约束已生效。
 - 与 `_instruction-guard` 配合：在读取指令后执行文件输出约束。
diff --git a/.agent/skills/_git-commit/SKILL.md b/.agent/skills/_git-commit/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _git-commit
+name: git-commit
 description: Implements Conventional Commits workflow. Ensures proper commit message formatting with structured body, footer, and skill signature. Facilitates semantic versioning compliance and clean project history.
 ---
 

diff --git a/.agent/skills/_instruction-guard/SKILL.md b/.agent/skills/_instruction-guard/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _instruction-guard
+name: instruction-guard
 description: 强制在每次回复前读取项目指令文件，避免遗漏规范。与 _context-ack 配合，仅负责“读取约束”，不负责输出格式。
 ---
 

diff --git a/.agent/skills/_pr-creator/SKILL.md b/.agent/skills/_pr-creator/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _pr-creator
+name: pr-creator
 description: Automate PR generation with version detection and release notes. Streamlines contribution workflow and version management. Creates professional PR descriptions with checklist and automation templates.
 ---
 

diff --git a/.agent/skills/_release-process/SKILL.md b/.agent/skills/_release-process/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _release-process
+name: release-process
 description: Complete release workflow for project versioning. Covers branch creation, testing validation, documentation updates, PR creation via skills, and GitHub Release creation. Emphasizes stability through branch isolation strategy.
 ---
 

diff --git a/.agent/skills/_session-safety/SKILL.md b/.agent/skills/_session-safety/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _session-safety
+name: session-safety
 description: 会话输出安全控制。防止超长输出导致失败，必要时分段写入文件。
 ---
 

diff --git a/.agent/skills/_skills-manager/SKILL.md b/.agent/skills/_skills-manager/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _skills-manager
+name: skills-manager
 description: Core skill manager for evoskills. Handles skill lifecycle (init, install, remove, update) and skill contributions.
 ---
 

diff --git a/.agent/skills/_traceability-check/SKILL.md b/.agent/skills/_traceability-check/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _traceability-check
+name: traceability-check
 description: 校验“说明内容 ↔ 实际变更文件”的一致性，避免描述遗漏或偏差。
 ---
 

diff --git a/.agent/skills/_typescript-type-safety/SKILL.md b/.agent/skills/_typescript-type-safety/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: _typescript-type-safety
+name: typescript-type-safety
 description: Enforce TypeScript type safety guidelines. Ensures proper typing, prevents type-related runtime errors. Focuses on mock data creation, enum handling, and complex type initialization.
 ---
 

diff --git a/README.md b/README.md
@@ -36,6 +36,20 @@ evoskills --help
 npx @xingyu.wang/evoskills init
 ```
 
+### Option 3: AI Integration (One-sentence setup)
+
+Tell your AI assistant (e.g., GitHub Copilot) directly:
+
+> Please integrate the skills from https://github.com/wxy/evoskills into this project.
+
+The AI will read this README, understand the skill system, and execute the setup via the CLI:
+
+```bash
+npx @xingyu.wang/evoskills init
+```
+
+This works with any AI assistant that can browse GitHub URLs. The CLI handles all file placement, registry generation, and content protection — direct file copying is not supported and will result in an incomplete setup.
+
 ## 🚀 Quick Start
 
 Initialize evoskills in your project: