huashu-skill-updater

Checks installed huashu-family skills against remote GitHub repositories and reports available updates.

1.5k|229|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/alchaincyf/huashu-skills --skill huashu-skill-updater
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: huashu-skill-updater
Source: https://github.com/alchaincyf/huashu-skills/tree/main/huashu-skill-updater
Command: npx skills add https://github.com/alchaincyf/huashu-skills --skill huashu-skill-updater

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Skills installed from the huashu ecosystem (huashu-*, nuwa, darwin, freud, seedance, tramstop, dukou) are continuously iterated, and locally installed copies silently fall behind. This Skill detects outdated installations so users never run stale versions without knowing it.

Core Features & Use Cases

  • Full-directory scan: Runs a Python script that scans the skills directory, identifies huashu-family skills via .git origin or .huashu-skill-meta.json, and compares local commits against remote HEAD on GitHub.
  • Three-state report: Outputs each skill as up-to-date, outdated (with the exact update command), or unknown, and exits with code 1 when updates exist so it can plug into cron jobs.
  • Guided update workflow: Distinguishes git-clone installs (git pull --ff-only) from copy installs (re-clone and overwrite the subdirectory), warns before overwriting local modifications, and refreshes last_checked timestamps with --mark-checked.
  • Use Case: A user says "check my huashu skills for updates" once a month; the agent runs the script, translates the report into plain language, lists which skills are behind by how many commits, and asks which ones to update.

Quick Start

Ask your AI agent to check whether all installed huashu skills are up to date and list any available updates.

Frequently Asked Questions about huashu-skill-updater

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my installed Claude skills are outdated?

Run the check_updates.py script against your skills directory. It scans each subdirectory, identifies huashu-family skills by their git origin or metadata file, compares local commits to remote HEAD on GitHub, and prints an up-to-date, outdated, or unknown status for each.

How do I update a skill installed by copying a subdirectory?

Re-clone the source repository to a temporary directory, then overwrite the installed subdirectory with the fresh copy. Afterward, update the commit and installed_at fields in the skill's .huashu-skill-meta.json file so future checks compare against the correct baseline.

Can I schedule automatic skill update checks with cron?

Yes. The script exits with code 1 when updates are available, making it cron-friendly. Add a monthly entry such as running check_updates.py with --mark-checked on the first of each month to check all skills and refresh their last-checked timestamps.

What happens if I modified a skill locally before updating?

The update instructions require checking for local changes first, via git status for clone installs or directory mtime for copy installs. If modifications exist, the agent must warn you that updating will overwrite them and ask for confirmation before proceeding.

Does the update checker work for skills installed outside ~/.claude/skills?

Yes. Pass the --skills-dir argument to point the script at any directory, such as a project-level skills folder or a directory used by another agent. The default target is ~/.claude/skills when no argument is given.