Skip to content

fix(skills): add check-global-skills.sh doctor + repoint dead symlinks (#454) - #456

Merged
growlf merged 1 commit into
mainfrom
454-fix-dead-symlinks
Oct 25, 2026
Merged

growlf merged 1 commit into
mainfrom
454-fix-dead-symlinks

Conversation

@growlf

@growlf growlf commented Oct 25, 2026

Copy link
Copy Markdown
Owner

Closes #454

Adds bin/check-global-skills.sh — a doctor script that reports broken global
skill symlinks in ~/.config/opencode/skills/ and can repoint them to the main
checkout.

Problem: 33 of 45 global skills pointed into a deleted worktree (opskit-wt-437).
A missing skill is silent — the agent behaves as though the procedure was never
needed.

Fix: --fix repoints every broken symlink to the stable main checkout
(~/Projects/opskit), so removing a worktree can no longer silently break skills.

Usage

bin/check-global-skills.sh              # report broken links (exit 1 if found)
bin/check-global-skills.sh --fix        # repoint all broken links to main checkout

Test

4 tests: no skills dir, no broken links, broken link detected, fix repairs.

Also applied

The 33 broken symlinks have been manually repointed to the main checkout.
Zero broken links remain.

…nks (#454)

bin/check-global-skills.sh — reports broken global skill symlinks in
~/.config/opencode/skills/ and can repoint them to the main checkout.

Global skills are the only route by which an opskit procedure reaches a
session running in another project. A missing skill is silent — the agent
behaves as though the procedure was never needed.

Usage:
  bin/check-global-skills.sh              # report broken links (exit 1)
  bin/check-global-skills.sh --fix        # repoint to main checkout
@growlf
growlf merged commit 44d20af into main Oct 25, 2026
9 checks passed
@growlf
growlf deleted the 454-fix-dead-symlinks branch October 25, 2026 22:07
growlf added a commit that referenced this pull request Oct 25, 2026
…ktree fix, dead symlinks doctor (#457)

Grind processed two issues:

#451: check-worktree.sh primary checkout detection fix using --git-common-dir
vs --absolute-git-dir; also fixes GREEN unbound var bug; 8 real-repo tests.
Collateral: Caddyfile redirect support, 2 KB articles. PR #451 (squash 615cd34).

#454: 33 dead global skill symlinks → fixed by adding bin/check-global-skills.sh
doctor (reports + repoints to main checkout); 4 tests. All 33 repointed manually.
PR #456 (squash 44d20af).

Also documents remaining uncommitted files from other sessions.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Global OpenCode skills: 33 of 45 symlinks dead after worktree cleanup

1 participant