Skip to content
Back to search

skills-updater

SkillWorks with Claude CodeGitHub

Check and update installed Claude Code skills from multiple sources (Claude plugins and npx skills). Scans for available updates, supports batch or individual updates with intelligent local change merging, and recommends popular skills from skillsmp.com and skills.sh marketplaces. Use when users want to update skills, check for new versions, discover trending skills, or manage their skill collection.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yizhiyanhua-ai--skills-updater/badge.svg)](/listings/yizhiyanhua-ai--skills-updater)

HTML

<a href="/listings/yizhiyanhua-ai--skills-updater"><img src="/api/listings/yizhiyanhua-ai--skills-updater/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

在 Claude Code 中输入以下命令,自动克隆并安装:

帮我把 https://github.com/yizhiyanhua-ai/skills-updater 克隆到 ~/.claude/skills/ 目录

或者直接说:

安装 skills-updater 技能

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 335 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: skills-updater
  3. description: Check and update installed Claude Code skills from multiple sources (Claude plugins and npx skills). Scans for available updates, supports batch or individual updates with intelligent local change merging, and recommends popular skills from skillsmp.com and skills.sh marketplaces. Use when users want to update skills, check for new versions, discover trending skills, or manage their skill collection.
  4. ---
  5. # Skills Updater
  6. Manage, update, and discover Claude Code skills across multiple installation sources.
  7. ## Internationalization (i18n)
  8. All scripts automatically detect user locale from environment variables and display output in the appropriate language.
  9. **Supported Languages:**
  10. - English (en) - Default
  11. - Chinese (zh) - 中文
  12. **Auto-detection order:**
  13. 1. `LANG` environment variable
  14. 2. `LC_ALL` environment variable
  15. 3. `LANGUAGE` environment variable
  16. 4. System locale
  17. **Manual override:**
  18. ```bash
  19. python scripts/check_updates.py --lang zh # Force Chinese
  20. python scripts/check_updates.py --lang en # Force English
  21. ```
  22. ## Supported Sources
  23. **Claude Code Plugins** (`~/.claude/plugins/`):
  24. - `installed_plugins.json` - Tracks installed skills with versions
  25. - `known_marketplaces.json` - Registered marketplace sources
  26. - `cache/` - Installed skill files
  27. **npx skills** (`~/.skills/` if present):
  28. - Skills installed via `npx skills add <owner/repo>`
  29. - Managed by skills.sh infrastructure
  30. ## Update Check Workflow
  31. ### Step 1: Scan Installed Skills
  32. ```bash
  33. python scripts/check_updates.py
  34. ```
  35. Output format:
  36. ```
  37. 📦 Installed Skills Status
  38. ━━━━━━━━━━━━━━━━━━━━━━━━━━
  39. ✅ Up-to-date (12):
  40. • skill-creator@daymade-skills (1.2.2)
  41. • github-ops@daymade-skills (1.0.0)
  42. ...
  43. ⬆️ Updates Available (3):
  44. • planning-with-files@planning-with-files
  45. Local: 2.5.0 → Remote: 2.6.1
  46. • superpowers@superpowers-marketplace
  47. Local: 4.0.3 → Remote: 4.1.0
  48. ...
  49. ⚠️ Unknown Version (2):
  50. • document-skills@anthropic-agent-skills (unknown)
  51. ...
  52. ```
  53. ### Step 2: Confirm Update Strategy
  54. Present options to user:
  55. 1. **Update All** - Update all skills with available updates
  56. 2. **Select Individual** - Let user choose specific skills to update
  57. 3. **Skip** - Cancel the update process
  58. ### Step 3: Handle Local Modifications
  59. Before updating, check for local modifications:
  60. ```bash
  61. # Check if local skill has uncommitted changes
  62. cd ~/.claude/plugins/cache/<marketplace>/<skill>/<version>
  63. git status --porcelain
  64. ```
  65. **If local changes detected:**
  66. 1. Create backup of modified files
  67. 2. Pull remote updates
  68. 3. Attempt 3-way merge
  69. 4. If conflicts:
  70. - Show conflict files to user
  71. - Offer manual resolution or keep local version
  72. ### Step 4: Execute Update
  73. For Claude Code plugins:
  74. ```bash
  75. # Trigger marketplace refresh and skill reinstall
  76. # This uses Claude Code's built-in update mechanism
  77. claude /install <skill-name>@<marketplace>
  78. ```
  79. For npx skills:
  80. ```bash
  81. npx skills add <owner/repo> --force
  82. ```
  83. ## Auto-Install After Marketplace Update
  84. The `update_marketplace.py` script can automatically reinstall affected skills after updating a marketplace repository.
  85. ### Usage
  86. ```bash
  87. # Update marketplace only (show affected skills)
  88. python scripts/update_marketplace.py anthropic-agent-skills
  89. # Update marketplace AND auto-reinstall affected skills
  90. python scripts/update_marketplace.py anthropic-agent-skills --auto-install
  91. # Output as JSON
  92. python scripts/update_marketplace.py anthropic-agent-skills --json
  93. # Force language
  94. python scripts/update_marketplace.py anthropic-agent-skills --lang zh
  95. ```
  96. ### Output (Chinese locale)
  97. ```
  98. 📡 正在获取远程更新...
  99. 当前提交: e5c60158df67
  100. 远程提交: 69c0b1a06741
  101. 状态: 落后 6 个提交
  102. 📝 更新内容:
  103. • 69c0b1a Add link to Agent Skills specification website
  104. • be229a5 Fix links in agent skills specification
  105. ...
  106. 📦 受影响的技能: document-skills
  107. 📥 正在更新市场: anthropic-agent-skills
  108. ✅ 市场更新成功
  109. 🔄 正在重新安装受影响的技能...
  110. 正在安装: document-skills
  111. ✅ 已安装: document-skills
  112. ✅ 所有受影响的技能已更新
  113. ```
  114. ### Workflow
  115. 1. **Fetch remote** - Git fetch to check for updates
  116. 2. **Compare commits** - Show how many commits behind
  117. 3. **List affected skills** - Find installed skills from this marketplace
  118. 4. **Pull updates** - Git pull to update local marketplace
  119. 5. **Auto-reinstall** - (with `--auto-install`) Reinstall each affected skill
  120. ## Skill Recommendations
  121. ### Fetch Trending Skills
  122. ```bash
  123. python scripts/recommend_skills.py --source all
  124. ```
  125. Sources:
  126. - **skills.sh** - Leaderboard ranked by installs
  127. - **skillsmp.com** - Curated marketplace (if accessible)
  128. ### Output Format
  129. ```
  130. 🔥 Trending Skills
  131. ━━━━━━━━━━━━━━━━━━
  132. From skills.sh:
  133. 1. vercel-react-best-practices (25.5K installs)
  134. npx skills add vercel/react-best-practices
  135. 2. web-design-guidelines (19.2K installs)
  136. npx skills add webdesign/guidelines
  137. 3. remotion-best-practices (2.2K installs)
  138. npx skills add remotion/best-practices
  139. 💡 Personalized Recommendations:
  140. Based on your installed skills (developer-tools, productivity):
  141. - playwright-skill - Browser automation testing
  142. - github-ops - GitHub CLI operations
  143. ```
  144. ### Install Recommended Skill
  145. After showing recommendations, offer to install:
  146. ```
  147. Would you like to install any of these skills?
  148. 1. Install by number (e.g., "1" or "1,3,5")
  149. 2. Install by name
  150. 3. Skip
  151. ```
  152. ## Version Detection Methods
  153. ### Primary: marketplace.json
  154. Read version from remote marketplace.json:
  155. ```bash
  156. curl -s "https://raw.githubusercontent.com/<owner>/<repo>/main/.claude-plugin/marketplace.json" | jq '.plugins[] | select(.name == "<skill>") | .version'
  157. ```
  158. ### Fallback: GitHub API
  159. If marketplace.json unavailable or version not specified:
  160. ```bash
  161. # Get latest release tag
  162. curl -s "https://api.github.com/repos/<owner>/<repo>/releases/latest" | jq -r '.tag_name'
  163. # Or latest commit on main
  164. curl -s "https://api.github.com/repos/<owner>/<repo>/commits/main" | jq -r '.sha[:7]'
  165. ```
  166. ### Commit SHA Comparison
  167. For skills tracking by commit (e.g., `e30768372b41`):
  168. ```bash
  169. # Compare local gitCommitSha with remote HEAD
  170. local_sha=$(jq -r '.plugins["<key>"][0].gitCommitSha' ~/.claude/plugins/installed_plugins.json)
  171. remote_sha=$(curl -s "https://api.github.com/repos/<owner>/<repo>/commits/main" | jq -r '.sha')
  172. if [ "$local_sha" != "$remote_sha" ]; then
  173. echo "Update available"
  174. fi
  175. ```
  176. ## Smart Merge Strategy
  177. When local modifications exist:
  178. 1. **Identify modified files**:
  179. ```bash
  180. git diff --name-only HEAD
  181. ```
  182. 2. **Categorize changes**:
  183. - SKILL.md customizations → Preserve user sections
  184. - scripts/ modifications → Keep local, note for review
  185. - references/ additions → Merge both
  186. - assets/ → Keep both versions if different
  187. 3. **Merge approach**:
  188. ```python
  189. # Pseudo-code for smart merge
  190. for file in modified_files:
  191. if file == 'SKILL.md':
  192. merge_skill_md(local, remote) # Preserve user customizations
  193. elif file.startswith('scripts/'):
  194. backup_and_warn(local) # User scripts need review
  195. else:
  196. three_way_merge(base, local, remote)
  197. ```
  198. ## User Interaction Patterns
  199. ### Check for Updates
  200. User says: "检查 skills 更新" / "check skill updates" / "update my skills"
  201. → Run `scripts/check_updates.py` and display results
  202. ### Update Specific Skill
  203. User says: "更新 skill-creator" / "update skill-creator"
  204. → Check and update only the specified skill
  205. ### Discover New Skills
  206. User says: "推荐一些好用的 skills" / "recommend skills" / "popular skills"
  207. → Run `scripts/recommend_skills.py` and show curated list
  208. ### Full Update Workflow
  209. User says: "更新所有 skills" / "update all skills"
  210. → Scan → Confirm → Handle merges → Update → Report results
  211. ## Error Handling
  212. **Network errors**: Retry with exponential backoff, cache last known state
  213. **Permission errors**: Suggest running with appropriate permissions
  214. **Merge conflicts**: Show conflict markers, offer resolution options:
  215. - Accept local (keep your changes)
  216. - Accept remote (use upstream)
  217. - Manual merge (show diff)
  218. **Missing marketplace**: Inform user if source is no longer available
  219. ## Resources
  220. ### scripts/
  221. - `check_updates.py` - Scan and compare installed vs remote versions
  222. - `recommend_skills.py` - Fetch trending skills from marketplaces
  223. - `update_marketplace.py` - Update marketplace repos and auto-reinstall skills
  224. - `i18n.py` - Internationalization module (locale detection, translations)
  225. ### references/
  226. - `marketplaces.md` - Supported marketplace documentation
  227. ## Adding New Languages
  228. To add a new language, edit `scripts/i18n.py`:
  229. 1. Add translations to `TRANSLATIONS` dict:
  230. ```python
  231. TRANSLATIONS["ja"] = {
  232. "checking_updates": "スキルの更新を確認中...",
  233. # ... other translations
  234. }
  235. ```
  236. 2. Update `detect_locale()` to recognize the new locale:
  237. ```python
  238. if lang_lower.startswith('ja'):
  239. return 'ja'
  240. ```
README.md · README · 143 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Skills Updater
  2. 管理、更新和发现 Claude Code 技能,支持多种安装来源。
  3. [English](README.en.md)
  4. ## 功能特性
  5. - **更新检查** - 扫描已安装技能,检查可用更新
  6. - **自动安装** - 市场更新后自动重新安装受影响的技能
  7. - **技能推荐** - 从 skills.sh 发现热门技能
  8. - **国际化支持** - 自动检测语言环境(中文/英文)
  9. ## 安装
  10. 在 Claude Code 中输入以下命令,自动克隆并安装:
  11. ```
  12. 帮我把 https://github.com/yizhiyanhua-ai/skills-updater 克隆到 ~/.claude/skills/ 目录
  13. ```
  14. 或者直接说:
  15. ```
  16. 安装 skills-updater 技能
  17. ```
  18. ## 使用方法
  19. 安装完成后,在 Claude Code 中用自然语言或命令触发:
  20. ### 检查技能更新
  21. ```
  22. 检查 skills 更新
  23. ```
  24. ```
  25. /skills-updater
  26. ```
  27. ### 更新指定市场
  28. ```
  29. 更新 anthropic-agent-skills 市场
  30. ```
  31. ### 发现新技能
  32. ```
  33. 推荐一些好用的 skills
  34. ```
  35. ```
  36. 有什么热门技能推荐?
  37. ```
  38. ## 使用示例
  39. **示例 1:检查更新**
  40. ```
  41. 你:检查 skills 更新
  42. Claude:正在检查技能更新...
  43. 📦 已安装技能状态
  44. ━━━━━━━━━━━━━━━━━━━━━━━━━━
  45. ✅ 已是最新 (15):
  46. • skill-creator@daymade-skills (1.2.2)
  47. ...
  48. ⬆️ 有可用更新 (1):
  49. • document-skills@anthropic-agent-skills
  50. 本地: e5c60158 → 远程: 69c0b1a0
  51. ```
  52. **示例 2:更新并自动安装**
  53. ```
  54. 你:更新 anthropic-agent-skills 市场
  55. Claude:
  56. 📡 正在获取远程更新...
  57. 当前提交: e5c60158df67
  58. 远程提交: 69c0b1a06741
  59. 状态: 落后 6 个提交
  60. 📦 受影响的技能: document-skills
  61. 是否要更新?输入「是」确认。
  62. 你:是
  63. Claude:
  64. 📥 正在更新市场: anthropic-agent-skills
  65. ✅ 市场更新成功
  66. ✅ 已重新安装: document-skills
  67. ```
  68. **示例 3:发现新技能**
  69. ```
  70. 你:推荐一些好用的 skills
  71. Claude:
  72. 🔥 热门技能
  73. ━━━━━━━━━━━━━━━━━━
  74. 来自 skills.sh (前 10 名):
  75. 1. vercel-react-best-practices (25.5K 次安装)
  76. 2. web-design-guidelines (19.2K 次安装)
  77. ...
  78. 💡 个性化推荐
  79. 基于您已安装的技能:
  80. • playwright-skill - 浏览器自动化测试
  81. • github-ops - GitHub CLI 操作
  82. ```
  83. ## 触发方式汇总
  84. | 功能 | 自然语言 | 命令 |
  85. |------|----------|------|
  86. | 检查更新 | "检查 skills 更新" | `/skills-updater` |
  87. | 更新市场 | "更新 xxx 市场" | - |
  88. | 技能推荐 | "推荐一些 skills" | - |
  89. | 更新全部 | "更新所有 skills" | - |
  90. ## 语言支持
  91. 自动根据系统语言显示中文或英文。Claude Code 会自动检测您的语言环境。
  92. ## 详细文档
  93. - [SKILL.md](SKILL.md) - 完整技能文档
  94. - [references/marketplaces.md](references/marketplaces.md) - 支持的市场列表
  95. ## 许可证
  96. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.