← Back to Skills Marketplace
viccwang

GitHub Skill Updater

by vicwang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
126
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install github-skill-updater
Description
检查并更新通过 GitHub git clone 安装的 OpenClaw skills。适用于用户提到“更新skill”“更新 skill”“检查 skill 是否有新版本”“GitHub 安装的 skill 有没更新”“帮我检查本地 skills 是否落后”“更新 git clone 装的 skill”“拉取...
README (SKILL.md)

GitHub Skill Updater

用于检查和更新“通过 GitHub git clone 安装”的 OpenClaw skills。

触发条件

当用户表达下面这类意图时,应触发这个 skill:

  • 更新 skill
  • 更新某个 GitHub 安装的 skill
  • 检查 skill 是否有新版本
  • 拉取某个 skill 的最新代码
  • 看看 workspace 里的 skills 哪些落后了
  • 批量更新 git clone 安装的 skills

适用范围

  • 适用:
    • skill 目录里保留 .git
    • skill 有 origin 远端
    • skill 在 branch 或精确 tag 上
  • 不适用:
    • 下载 zip 后手工拷贝的 skill
    • 没有 .git 的普通目录
    • detached HEAD 且不在精确 tag 上的仓库

默认流程

  1. 先做检查,不直接更新。
  2. 发现 dirtyaheaddiverged 时默认停止,向用户说明原因。
  3. 只有 update-available 才执行更新。

推荐命令

如果当前目录就是 OpenClaw workspace 根目录,推荐直接用包装命令:

./skills/github-skill-updater/scripts/github-skill-updater check skills

更新单个 skill:

./skills/github-skill-updater/scripts/github-skill-updater update skills/\x3Cskill-name>

也可以直接调用 Python 主脚本:

python3 skills/github-skill-updater/scripts/manage_github_skill.py check skills

批量输出 JSON:

./skills/github-skill-updater/scripts/github-skill-updater check skills --json

输出解释

  • up-to-date: 已是最新
  • update-available: 有可更新内容
  • dirty: 有未提交改动,默认不更新
  • ahead: 本地领先远端,默认不更新
  • diverged: 本地与远端分叉,默认不更新
  • unsupported: 目录不满足自动判断条件

实施要求

  • 使用脚本 scripts/manage_github_skill.py
  • 更新前必须先执行检查
  • branch 模式仅允许 fast-forward 更新
  • tag 模式只切换到更新的 tag,不做强制重置

失败兜底

如果脚本返回 unsupported

  • 检查该 skill 是否真的是 git clone 安装
  • 确认目录里是否保留 .git
  • 确认是否存在 origin
  • 如无 git 元数据,只能手工重新安装或手工替换
Usage Guidance
This skill appears to do exactly what it says: check local, git-cloned skills and optionally fast-forward or switch tags. Before running updates: (1) run the check mode (or use --json) to inspect which repos are out-of-date; (2) verify remote URLs are trusted (it will contact origins and use your git credentials); (3) ensure you have backups or can revert changes if an update breaks a skill; (4) prefer manual invocation for update operations unless you trust autonomous agent actions. If you want to limit risk, run only 'check' from the agent and perform updates yourself from a shell.
Capability Analysis
Type: OpenClaw Skill Name: github-skill-updater Version: 1.0.0 The github-skill-updater skill is a utility designed to check and update OpenClaw skills installed via git clone. The core logic in manage_github_skill.py uses safe subprocess calls to execute standard git commands (fetch, pull, checkout) and includes safety checks to prevent overwriting local changes (dirty/diverged states). No evidence of data exfiltration, shell injection, or malicious prompt manipulation was found.
Capability Assessment
Purpose & Capability
The name/description describe checking and updating git-cloned skills and the code (manage_github_skill.py) implements exactly that using git CLI calls. There are no unrelated env vars, binaries, or network endpoints declared.
Instruction Scope
SKILL.md and the script limit actions to detecting repo status and performing safe updates (fast-forward for branches, tag checkout). However, the runtime commands perform 'git fetch'/'git pull'/'git checkout' which will contact remotes and can modify local skill directories. This behavior is expected for its purpose but is destructive if used improperly, so users should review results before applying updates.
Install Mechanism
No install spec or remote downloads are present; the skill is instruction + local Python script. It does not fetch arbitrary code from unknown URLs during install, so install risk is low.
Credentials
The skill declares no required environment variables or secrets. Note: git network operations implicitly use the user's git credentials (SSH keys, credential helpers, or stored HTTPS credentials) when contacting origin; this is expected but worth being aware of.
Persistence & Privilege
always is false. The skill can be invoked autonomously (platform default). If invoked, it can run git operations that change local files. This matches its purpose but means you should be comfortable with an agent having the ability to update local skill repos.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-skill-updater
  3. After installation, invoke the skill by name or use /github-skill-updater
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of github-skill-updater. - Provides a tool to check and update OpenClaw skills installed via GitHub git clone. - Only supports skill directories with retained .git metadata and an origin remote. - Handles update checks, notifies of local changes or divergence, and only updates if appropriate. - Includes recommended commands for batch and single skill updates. - Outputs reasons for not updating (dirty, ahead, diverged, unsupported) and provides fallback advice.
Metadata
Slug github-skill-updater
Version 1.0.0
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is GitHub Skill Updater?

检查并更新通过 GitHub git clone 安装的 OpenClaw skills。适用于用户提到“更新skill”“更新 skill”“检查 skill 是否有新版本”“GitHub 安装的 skill 有没更新”“帮我检查本地 skills 是否落后”“更新 git clone 装的 skill”“拉取... It is an AI Agent Skill for Claude Code / OpenClaw, with 126 downloads so far.

How do I install GitHub Skill Updater?

Run "/install github-skill-updater" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GitHub Skill Updater free?

Yes, GitHub Skill Updater is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GitHub Skill Updater support?

GitHub Skill Updater is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub Skill Updater?

It is built and maintained by vicwang (@viccwang); the current version is v1.0.0.

💬 Comments