skill-updater

A Claude Code skill that scans all your installed skills, checks if they come from open-source GitHub repos, and detects available updates across multiple sources.

Chinese / 中文版

Features

• Scans both project-level and global Claude Code skills
• Cross-references skills-lock.json to identify GitHub-sourced skills
• Checks for updates via GitHub API (gh CLI) with tree hash comparison
• Checks for updates via skills.sh marketplace (npx skills check)
• Detects locally modified skills vs upstream
• Reports missing skills (in lock file but not on disk)
• JSON output for scripting
• Repo-level tree caching for fast batch checks

Install

# Via Skills CLI (recommended)
npx skills add crawfordxx/skill-updater -g -y

# Or manually
git clone https://github.com/crawfordxx/skill-updater.git ~/.claude/skills/skill-updater

Usage

Quick Overview

List all skills and their sources (no network calls):

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py

Check GitHub Updates

Compare local skill hashes against remote repos:

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates

Check Marketplace Updates

Also query skills.sh for updates:

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --marketplace

Full Check

Combine all sources:

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --marketplace

Show Only Outdated

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --outdated-only

JSON Output

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --json

Options

Flag	Description
--project-dir PATH	Project root (default: cwd)
--global-dir PATH	Global skills dir (default: ~/.claude/skills)
--lock-file PATH	Path to skills-lock.json
--check-updates	Query GitHub API for updates (requires gh CLI)
--marketplace	Query skills.sh for updates
--json	JSON output
--outdated-only	Only show skills with updates

Status Icons

Icon	Status	Meaning
✓	up-to-date	Local matches upstream
·	tracked	In lock file (no remote check)
↑	update-available	Newer version exists
~	locally-modified	Local edits differ from installed
?	unknown	Could not check upstream
!	missing	In lock file but not on disk

Data Sources

Source	Method	What it checks
skills-lock.json	Local file	Which skills are from GitHub, their install hashes
GitHub API	gh api tree comparison	Whether remote repo has changed since install
skills.sh	npx skills check	Marketplace update detection

Requirements

• Python 3.8+
• gh CLI installed and authenticated (for --check-updates)
• Node.js / npx (for --marketplace)

Example Output

Total skills scanned: 152
  From GitHub: 29
  Local/custom: 112
  Marketplace updates: 13

========================================================================
GITHUB-SOURCED SKILLS
========================================================================

  pbakaus/impeccable (21 skills)
  ──────────────────────────────────────────────────
    ✓ adapt                               [up-to-date]
    ↑ animate                             [update-available]
       -> claude skill install pbakaus/impeccable
    ~ harden                              [locally-modified]
       Local files differ from installed version

License

MIT

---

中文说明

一个 Claude Code skill，用于扫描所有已安装的 skill，检查它们是否来自 GitHub 开源仓库，并从多个来源检测可用更新。

功能

• 扫描项目级和全局 Claude Code skills
• 通过 skills-lock.json 识别来自 GitHub 的 skills
• 通过 GitHub API（gh CLI）对比 tree hash 检测更新
• 通过 skills.sh 市场（npx skills check）检测更新
• 检测本地修改过的 skill
• 报告缺失的 skill（lock 文件中有但磁盘上没有）
• 支持 JSON 输出，方便脚本处理
• 同一 repo 的多个 skill 共享缓存，加速批量检查

安装

# 通过 Skills CLI 安装（推荐）
npx skills add crawfordxx/skill-updater -g -y

# 或手动克隆
git clone https://github.com/crawfordxx/skill-updater.git ~/.claude/skills/skill-updater

使用方法

快速概览

列出所有 skill 及来源（不需要网络）：

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py

检查 GitHub 更新

对比本地 hash 和远程仓库：

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates

检查市场更新

同时查询 skills.sh：

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --marketplace

全面检查

组合所有来源：

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --marketplace

只显示需要更新的

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --outdated-only

JSON 输出

python3 ~/.claude/skills/skill-updater/scripts/scan_skills.py --check-updates --json

参数说明

参数	说明
--project-dir PATH	项目根目录（默认: 当前目录）
--global-dir PATH	全局 skills 目录（默认: ~/.claude/skills）
--lock-file PATH	skills-lock.json 路径
--check-updates	通过 GitHub API 检查更新（需要 gh CLI）
--marketplace	通过 skills.sh 检查更新
--json	JSON 格式输出
--outdated-only	只显示有更新的 skill

状态图标

图标	状态	含义
✓	up-to-date	本地和远程一致
·	tracked	在 lock 文件中（未做远程检查）
↑	update-available	有更新版本
~	locally-modified	本地有改动
?	unknown	无法检查远程
!	missing	lock 文件中有但磁盘上没有

依赖

• Python 3.8+
• gh CLI 并已登录（用于 --check-updates）
• Node.js / npx（用于 --marketplace）

License

MIT