Claude Code Skill 菜单中文汉化指南:一行配置解决英文菜单痛点
痛点:装了 30 个 Skill,菜单里全是英文
昨天有个开发者在群里发了张截图:
/skills├── remotion-best-practices├── vercel-react-best-practices├── web-design-guidelines├── frontend-design├── seo-audit├── playwright-testing├── typescript-strict-mode├── accessibility-audit├── performance-budget└── docker-compose-best-practices他问了一个很多 Claude Code 用户都会遇到的问题:你装了 30 多个 Skill,但每次想用时,菜单里全是英文名字。remotion-best-practices 是干什么的?vercel-react-best-practices 和 react-best-practices 有什么区别?web-design-guidelines 包含哪些内容?
每次都要翻文档,或者一个个点进去看描述。
而经过汉化后的菜单是这样的:
/skills├── remotion-best-practices 视频剪辑工具├── vercel-react-best-practices React开发规范├── web-design-guidelines Web设计指南├── frontend-design 前端设计├── seo-audit SEO审计├── playwright-testing 浏览器自动化测试├── typescript-strict-mode TypeScript严格模式├── accessibility-audit 无障碍访问审计├── performance-budget 性能预算管理└── docker-compose-best-practices Docker编排规范一眼就知道每个 Skill 是干什么的,不用记英文名,不用翻文档,不用猜。
核心原理:SKILL.md 的 YAML Frontmatter
每个 Claude Code Skill 的配置文件都是一个 SKILL.md 文件,开头有一个 YAML 格式的 Frontmatter 区域:
---name: remotion-best-practicesdescription: Best practices for Remotion video development...---这里有两个关键字段:
| 字段 | 作用 | 显示位置 |
|---|---|---|
name | Skill 的标识名 | 菜单列表中显示 |
description | Skill 的详细说明 | 详细信息面板中显示 |
关键操作:把 name 字段改成 英文名 中文说明 的格式。
---name: remotion-best-practices 视频剪辑工具description: Remotion视频开发和动画工作流的最佳实践指南,包含转场动画、字幕、音频同步等开发技巧---两个字段的分工:
name:显示在/skills菜单列表中,建议用英文名 中文说明格式——保留英文是因为 Claude Code 内部通过 slug 匹配,中文只是为了给你看description:显示在详细信息中,完全可以写纯中文,详细说明这个 Skill 的功能、适用场景、前置条件
保存文件,再打开 Claude Code 输入 /,菜单里显示的就是:
/remotion-best-practices 视频剪辑工具实战:批量汉化 15+ 个中文 Skill
我自己部署的 OpenClaw + hermes-agent 环境里,装了十几个中文 Skill。下面是实际改造前后的对比:
热搜类 Skills
# 改造前---name: baidu-hot-cndescription: 百度热榜监控 | Baidu Hot Topics Monitor---
# 改造后---name: baidu-hot-cn 百度热搜description: 获取百度热搜榜、搜索趋势、关键词热度数据,支持自定义条数---# 改造前---name: zhihu-hot-cndescription: 知乎热榜监控 - 获取知乎热门话题---
# 改造后---name: zhihu-hot-cn 知乎热榜description: 获取知乎热门话题、问题和趋势分析,监控科技/互联网/职场等垂直领域---# 改造前---name: weibo-hot-trenddescription: 获取微博热搜榜数据---
# 改造后---name: weibo-hot-trend 微博热搜description: 获取微博热搜榜数据,返回热搜标题、热度值和跳转链接,支持自定义条数---飞书生态 Skills
# 改造前---name: feishu-bridgedescription: Connect a Feishu bot to Clawdbot via WebSocket---
# 改造后---name: feishu-bridge 飞书桥接description: 通过 WebSocket 长连接将飞书机器人接入 Agent,无需公网服务器和域名---为什么不全改中文名?
你可能会问:为什么不直接把 name 改成纯中文,比如 name: 百度热搜?
不建议纯中文名,原因有三个:
- Slug 匹配问题:Claude Code 内部通过 URL-friendly 的 slug 来匹配 Skill,纯中文 slug 可能在某些环境下出现编码问题
- 搜索友好:英文名方便在文件系统中
grep和find搜索,比如find . -name "*feishu*" - 兼容性:部分 Skill 加载器可能依赖
name字段做路径解析,混写中文可能导致加载失败
最佳实践是 英文名 中文说明 的混合格式,兼顾了技术兼容性和人类可读性。
进阶技巧:分类前缀 + 智能排序
技巧一:分类前缀,同类 Skill 排在一起
如果你装了特别多 Skill,可以用分类前缀来分组:
---name: 写作-文档生成description: 自动生成技术文档和说明------name: 写作-SEO审计description: SEO 优化和关键词分析------name: 开发-视频剪辑工具description: Remotion 视频开发工作流------name: 开发-React开发规范description: Vercel React 最佳实践------name: 设计-Web设计指南description: Web 设计规范和最佳实践------name: 设计-前端设计description: 前端 UI/UX 设计指导---这样菜单里同类 Skill 会排在一起,一目了然:
/skills├── 写作-文档生成├── 写作-SEO审计├── 开发-视频剪辑工具├── 开发-React开发规范├── 设计-Web设计指南└── 设计-前端设计技巧二:按使用频率排序
最新版本的 Claude Code 支持按使用频率自动排序。你不需要做任何配置,系统会自动把你最近常用的 Skill 排到前面。
推荐使用这个特性,因为它是自适应的——你越用,排序越智能。
技巧三:数字前缀(固定顺序)
如果你想完全控制顺序,可以加数字前缀:
---name: 01-baidu-hot-cn 百度热搜description: 百度热搜监控,每天必用---这样菜单会严格按数字顺序排列。适合那些每天必用的 Skill。
懒人福音:让 Claude Code 一键批量翻译
手动改 30 个 Skill 太累?让 Claude Code 自己帮你翻译!
打开 Claude Code,复制下面这段提示词:
请帮我批量为所有 Claude Code Skills 添加中文翻译。
任务:1. 扫描 ~/.claude/skills/ 目录下的所有 Skill2. 读取每个 Skill 的 SKILL.md 文件3. 检查 name 和 description 字段是否已有中文翻译4. 如果没有,根据 Skill 的英文名和 description,添加中文翻译5. 格式: - name: 英文名 中文说明(4-6字) - description: 完整的中文描述
要求:- name 的中文说明要简短(4-6字)- description 要完整翻译成中文,写详细一点- 保留原有英文名,只在后面添加中文- 不要修改其他字段- 处理完后告诉我修改了哪些 Skill
开始执行。粘贴到 Claude Code,回车。AI 会自动翻译,而且翻译得比你自己想的还准确。
⚠️ 注意:每次更新 Skill 后会被覆盖,需要重新执行一次翻译。
批量汉化脚本(进阶)
如果你更喜欢命令行,这里提供一个 Bash 批量汉化脚本:
#!/bin/bash# 一键汉化 Claude Code Skill 菜单# 用法:./localize-skills.sh ~/.claude/skills/
SKILLS_DIR="${1:-$HOME/.claude/skills}"
# 定义汉化映射(slug -> 中文说明)declare -A TRANSLATIONS=( ["remotion-best-practices"]="视频剪辑工具" ["vercel-react-best-practices"]="React开发规范" ["web-design-guidelines"]="Web设计指南" ["frontend-design"]="前端设计" ["seo-audit"]="SEO审计" ["playwright-testing"]="浏览器自动化测试" ["typescript-strict-mode"]="TypeScript严格模式" ["accessibility-audit"]="无障碍访问审计" ["performance-budget"]="性能预算管理" ["docker-compose-best-practices"]="Docker编排规范")
for skill_dir in "$SKILLS_DIR"/*/; do skill_file="$skill_dir/SKILL.md" if [[ ! -f "$skill_file" ]]; then continue fi
slug=$(basename "$skill_dir") translation="${TRANSLATIONS[$slug]}"
if [[ -z "$translation" ]]; then echo "⏭️ $slug 未配置翻译,跳过" continue fi
# 检查是否已经汉化过 if grep -q "name:.*${translation}" "$skill_file" 2>/dev/null; then echo "✅ $slug 已汉化,跳过" continue fi
# 修改 name 字段 sed -i "s/^name: ${slug}$/name: ${slug} ${translation}/" "$skill_file" echo "✅ $slug → ${slug} ${translation}"done
echo "🎉 批量汉化完成!"使用方法:
# 先预览(不实际修改)cat localize-skills.sh
# 执行汉化chmod +x localize-skills.sh./localize-skills.sh ~/.claude/skills/Claude Code 4.0+ 的 Skill 生态变化
随着 Claude Code 进入 4.0 时代,Skill 生态正在发生几个重要变化:
1. Skill 市场爆发
GitHub 上的 agentskills.io 已经收录了 500+ 个开源 Skill,涵盖:
- 前端开发(React/Vue/Svelte/Astro)
- 后端开发(Node.js/Python/Go)
- DevOps(Docker/K8s/CI/CD)
- AI 辅助(代码审查/文档生成/测试)
- 垂直领域(金融/医疗/教育)
2. 自定义 Skill 标准化
SKILL.md 的格式正在成为行业事实标准。不仅 Claude Code 在用,OpenClaw 的 hermes-agent、Cursor、GitHub Copilot 等工具都开始兼容这个格式。
3. 中文 Skill 生态崛起
国内开发者开始贡献中文原生 Skill,比如:
- 百度热搜监控:调用百度 API 获取实时热榜
- 飞书文档管理:读写飞书在线文档
- 抖音热榜:获取抖音热门话题和视频
- 今日头条:聚合新闻和技术资讯
这些 Skill 从第一天起就是中文友好的,name 和 description 都是中英双语。
常见问题
Q: 改了 name 后 Skill 还能正常使用吗?
能。 Claude Code 通过文件路径(目录名)来定位 Skill,而不是通过 name 字段。name 只是显示用。
Q: description 太长会怎样?
建议控制在 200 字以内。太长会导致菜单展开时占用过多空间,影响浏览体验。
Q: 如何批量检查哪些 Skill 还没汉化?
# 检查所有没有中文说明的 Skillfor f in ~/.claude/skills/*/SKILL.md; do name=$(grep "^name:" "$f" | head -1) # 如果 name 后面没有中文字符 if ! echo "$name" | grep -qP '[\x{4e00}-\x{9fff}]'; then echo "未汉化: $(dirname $f | xargs basename) → $name" fidoneQ: 团队共享 Skill 配置怎么办?
把汉化后的 skills/ 目录提交到 Git 仓库,团队成员 clone 后直接复制 ~/.claude/skills/ 即可。或者用 Symbolic Link 链接到共享目录。
总结
| 操作 | 耗时 | 效果 |
|---|---|---|
| 修改 1 个 Skill 的 name | 10 秒 | 菜单中显示中文说明 |
| 批量汉化 30 个 Skill | 2 分钟(用脚本) | 所有菜单一目了然 |
| 配置按频率排序 | 0(自动) | 常用 Skill 自动置顶 |
| 添加自定义 Skill | 5 分钟 | 扩展专属能力 |
一行配置,就能让 AI 编程工具的菜单从”天书”变成”人话”。 这不是花里胡哨的优化,而是实打实的效率提升——再也不用在 30 个英文名字里翻来翻去猜哪个是你要用的了。
下次打开 Claude Code,输入 / 的那一刻,你会感谢自己花了这两分钟。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!