dbs-update runs when you ask to update or upgrade dbskill, or reply 1 to an update notice. It detects how dbskill was installed, either as Claude Code plugins or through the skills CLI, and updates only that channel so you do not end up with two copies.
After the update it cleans out entries for skills that dbskill has retired. Links that point to official old versions are removed, folders that match an official old version are moved to a backup under your home folder, and anything you changed or named the same yourself is kept and reported. Your archives in the dbs folder are not touched.
What You Get
- The installed dbskill skills brought up to date for the channel you use
- Retired official skill entries removed, with backups of matching folders
- A list of same-name items that were kept because they differ from the official version
- A short success or failure message with the next step to take
Common Use Cases
- Updating dbskill after a new release without touching other installed skills
- Cleaning up skills that dbskill has dropped from its catalogue
- Checking that plugin and CLI installs are not both present
What Makes It Unique
It avoids the generic skills update command because that may update skills from other sources. It handles plugin and CLI installs separately, removes only copies it can match by hash to the official repository, and moves folders to a backup folder without deleting them. It leaves archives and records in your dbs folder alone.
Under The Hood
The skill instructs the agent to run shell commands: claude plugin marketplace update and claude plugin update, or the npx skills add command against the official repository, which downloads from the network. It then runs a bundled Python script that scans the skill folders of many agents under your home directory, removes dead or official-old links and moves matching folders to a dated backup folder. It writes a time stamp file under the dbs folder in your home directory. It asks for no credentials.