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

This page was translated automatically. Technical details may differ from the original. View the original

304 stars Quality 72 Trend 34MIT

Helps plugins automatically upgrade skills with DSH versions

Overview

DSH (DeepSeek Harness) is an AI running framework where "all functions exist in the form of plugins." The problem is: What this repository does is write all known pitfalls into AI-understandable upgrade manuals, letting AI (Claude Code, Codex, Gemini, etc.) help you safely migrate plugins to the new version. - : Each card records a real pitfall—what broke, why it broke, how to fix it, and the version of the information source. Sorted by version, from 0.1.0 to 8 to 0.1.3 to alpha.2 (alpha.5→ rc.1 has no plugin changes, 0 cards; alpha.2 →alpha.3 have 2 cards (1 new ability card + SQLite removes backfill); alpha.3 →alpha.4 have 6 cards; rc.8→rc.1 have 9 draft cards; 0.1.2-rc.1→0.1.3-alpha.1 has 5 cards (2 session-log tests + 3 stub tags), 0.1.3-alpha.1→0.1.3-alpha.2 has 5 draft cards). - :Some pitfalls are unrelated to the version (such as "back up before you do" or "how to coexist old and new versions"), and these are written into a countermeasure checklist. - :One unified workflow handles selection and orchestration, while the other eight are responsible for checking upgrades, writing new plugins, testing plugins, issuing plugins, comparing differences between two versions, troubleshooting runtime faults, integrating heavy dependencies for lightweight plugins, and extracting plugin upgrade experience into benchmark questions. - :Used to test whether AI will upgrade plugins after installing our skills, with each question automatically scoring; This includes two real migrations: dsh-web v0.3.8 → v0.3.9 and dsh-data-agent v0.1.3 → v0.1.4. - : We really installed two versions of DSH in Docker, verifying that "plugins can be fixed by following the card"; Afterwards, we used agents like Codex for multiple rounds of benchmark testing. First, add marketplace, then install/enable the plugin in the Codex plugin interface: Currently, Codex CLI does not directly install subcommands; Both GitHub and local paths are registered via plugin marketplace add. When the first call only calls the unified entry point and the target process is not yet specified, it lists 9 workflows and 14 optional capabilities, recommends read-only health-check but does not execute it automatically.

Overview (machine translated)

Chinese Simplified | English

Teach AI to help you upgrade your DSH plugin skill collection, community co-construction.

DSH (DeepSeek Harness) is an AI framework where “all functions exist as plugins.” The problem is: every time DSH releases a new version, old plugins may not start. This repository organizes known pitfalls into an AI-readable upgrade manual, letting agents like Claude Code, Codex, Gemini, and others safely migrate plugins to the new version, and using a set of public benchmarks to verify whether this is done correctly.

📄 > Paper: Evaluating Agent Skills for Version-Specific Plugin Migration: A Retrospective Study (arXiv:2609.30120). Evaluation methods and main findings are detailed in the paper section.

What’s in this warehouse?

198 upgrade instruction cards: Each card records a real pitfall—what broke, why, how to fix it, and which version the information came from. Sort by version corridor, covering 0.1.0-rc.8 → 0.2.0-rc.2 (among which 0.1.7-rc.1 → 0.1.7-rc.2 are not yet fully developed). The number of cards and their status for each edge are shown in the overlay table below.
13 General Countermeasures: Pitfalls unrelated to specific versions (backup, coexistence of old and new, what to do if startup freezes, etc.) are all collected in one checklist.
11 skills: The unified workflow is responsible for selection and orchestration, while the other nine are responsible for checking upgrades, writing plugins, testing plugins, issuing plugins, comparing two versions, troubleshooting runtime faults, accessing heavy dependencies, inspecting the entire batch of installed plugins after host upgrades, and extracting upgrade experiences into exam questions; There is also a general migration methodology without DSH proprietary knowledge, serving as a control group for control experiments.
63 automated benchmarking questions: 22 static diagnostics, 14 mixed tests, and 27 practical tests, including two real migrations of dsh-web and dsh-data-agent.
One paper and complete evaluation evidence: From original answers, item-by-item scoring to cross-model re-evaluation, all are publicly available and recalculable, see the paper below.

Get Started Quickly

Using skills CLI (recommended)

A command to install the agent it supports:

Claude Code

Marketplace Installation:

**SSH error? **If the GitHub SSH key is not configured, use HTTPS URL:

Local/Development Mode:

Codex

First, add marketplace, then install/enable the plugin in the Codex plugin interface:

Currently, Codex CLI does not directly install subcommands; Both GitHub and local paths are registered via plugin marketplace add.

Gemini CLI

Install directly from a warehouse or local cloning:

Cursor

Copy skills/ to '.

This page was translated automatically. Technical details may differ from the original.

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add oh-my-dsh/dsh-plugin-upgrade-skill

New to MCP? Start with the mcpskill.org guide →