plugin-upgrade SKILL.md skillA

plugin-upgrade from oh-my-dsh/dsh-plugin-upgrade-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add oh-my-dsh/dsh-plugin-upgrade-skill/plugin-upgrade@git:20261030.e3d971e

Pins git:20261030.e3d971e in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

oh-my-dsh/dsh-plugin-upgrade-skill

Path

skills/plugin-upgrade/SKILL.md

Versions recorded

21

Latest version

git:20261030.e3d971e, committed Oct 30, 2026

First version recorded

Sep 6, 2026

Size

34,109 bytes

Repository stars

317

License

MIT

Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review of already-migrated plugin source and version-boundary, API, dependency, activation, or runtime compatibility problems. Inspection and diagnosis stay read-only; show a plan and obtain confirmation before any configuration, dependency, or source write.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

English | [简体中文](SKILL.zh-CN.md)

# plugin-upgrade

Safely handle three task types: read-only update inspection, installed-plugin upgrades, and DSH host version compatibility migration. If user intent is unclear, confirm the mode first; never let "help me check for updates" slide into installing or changing code.

Note: the version cards and reference docs under `references/` are in English; card IDs and cited commands are language-neutral.

## Step 0: choose a mode

| Mode | User intent | Default allowed action |
|---|---|---|
| A · inspect | Check for updates or assess impact from a DSH release | Read-only investigation and report; then stop |
| B · update | Upgrade an installed plugin to an explicit version | Plan and confirm before changing composition or dependencies |
| C · author-migrate | Upgrade a plugin author's source repository for a newer DSH host | Baseline, build the version corridor and touchpoint inventory, then implement the approved migration |

This skill does not handle "upgrade DSH core only and leave the plugins alone," and it must not modify DSH core to conceal plugin incompatibility.

## Global DSH host upgrades (agent discipline)
…

Read the whole file at its exact version.

How to install

mdr add oh-my-dsh/dsh-plugin-upgrade-skill/plugin-upgrade@sha256:d89fc97d9f43abc4

[![mdr](https://markdownregistry.com/badge/art_wbb2vv2qpcxrrp5y.svg)](https://markdownregistry.com/a/art_wbb2vv2qpcxrrp5y)

Versions

The registry has recorded 21 versions of this file, between Sep 6, 2026 and Oct 30, 2026, about one every 3 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_wbb2vv2qpcxrrp5y
GET https://markdownregistry.com/api/v1/resolve?ref=oh-my-dsh/dsh-plugin-upgrade-skill/plugin-upgrade
GET https://markdownregistry.com/api/v1/blob/d89fc97d9f43abc4921e9d2813c79ff56b4364343893a0a008f863ae455a1f89

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from oh-my-dsh/dsh-plugin-upgrade-skill

Every file in oh-my-dsh/dsh-plugin-upgrade-skill

Other files named plugin-upgrade

Browse by kind, by grade A, or by owner.