npx gstack-skills — standalone skill manager for gstack (upgrade + install without setup)

[zzzhizhia]

Hey! I built gstack-skills — a lightweight CLI for managing gstack skills without running the full setup:

npx gstack-skills

• GitHub: https://github.com/zzzhizhia/gstack-skills
• npm: https://www.npmjs.com/package/gstack-skills

What it does:

• Shallow-clones this repo, diffs against local ~/.claude/skills/
• Interactive upgrade: shows changelog, lets you update all / pick / skip
• Interactive install: discovers new skills with descriptions, checkbox selection (space: toggle, a: all)
• Safe: backs up before updating, restores on error
• Zero dependencies on bun or the setup script

Who it's for:

• Users who want to try individual gstack skills without committing to a full setup
• Quick upgrades without git pull + ./setup
• Environments where bun isn't available

It currently discovers all 34 skills correctly from the repo.

Repo structure blocks per-skill discovery on skills.sh

skills.sh (npx skills add) is the standard way to discover and install individual skills from a GitHub repo. But npx skills add garrytan/gstack --list returns only 1 skill (the root meta-skill), because its discoverSkills() finds the root SKILL.md and early-returns without scanning subdirectories.

--full-depth works (npx skills add garrytan/gstack --list --full-depth → 37 skills), but users won't know to pass that flag.

Suggested fix: move skill directories into a skills/ subdirectory. The skills CLI's search path priority list includes skills/, so it would automatically discover all sub-skills after the root SKILL.md. This also helps with #267 and #594.

Related: #113, #267, #594