Skip to content

Explain how to keep installed skills up to date - #23

Merged
lucasrodes merged 1 commit into
mainfrom
docs/keep-skills-updated
Sep 16, 2026
Merged

lucasrodes merged 1 commit into
mainfrom
docs/keep-skills-updated

Conversation

@lucasrodes

Copy link
Copy Markdown
Member

Summary

  • Adds a Keeping the skills up to date subsection under Installation. It covers the three install routes the README already documents:
    • Claude Code plugin: auto-update is off by default for marketplaces other than Anthropic's own, so the section says how to enable it once (/plugin → Marketplaces → owid-skills → Enable auto-update) and gives the manual pair claude plugin marketplace update owid-skills + claude plugin update owid@owid-skills, noting that the first alone does not update the plugin.
    • skills CLI: npx skills update (-g / -p for scope).
    • Manual: a copy is frozen, a symlink into a clone follows git pull.
  • Changes "copies them into each one's directory" to "installs", since the skills CLI symlinks each agent directory to one canonical copy by default (--copy is the opt-in).

Why

Nothing in the README said how updates reach users. The versionless-plugin model described under Development only works once a user has enabled auto-update or refreshes by hand.

Verified against

  • Claude Code docs: Configure auto-updates ("Third-party and local development marketplaces have auto-update disabled by default") and the plugins reference (versionless plugins use the resolved commit SHA as their version).
  • claude plugin update --help and claude plugin marketplace update --help.
  • npx skills --help, plus an existing npx skills add install on my machine (canonical .agents/skills/ copy, symlinks from .claude/skills/, skills-lock.json).

A sibling PR adds the same section to owid/skills-private.

🤖 Generated with Claude Code

Every install route is a snapshot of main as it was that day, and Claude
Code disables marketplace auto-update by default for third-party
marketplaces, so "every commit is a release" only reaches users who turn it
on or update by hand. Add an Installation subsection that covers the Claude
Code plugin (enable auto-update once, or the marketplace-update plus
plugin-update pair), the skills CLI (npx skills update) and manual copies
or symlinks.

Also say the skills CLI "installs" rather than "copies": by default it
keeps one canonical copy and symlinks each agent's directory to it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@lucasrodes
lucasrodes merged commit e20df02 into main Sep 16, 2026
2 checks passed
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.

1 participant