Agent skill

Dsh Create Upgrade Guide

by Zhou-Yujing114514 in Zhou-Yujing114514/deepseek-harness-linux

A skill your agent uses when a deepseek-harness change breaks an externally perceptible surface (CLI, profiles, cordis.yml or settings keys, persisted user data, SDK or wire APIs, published package…

MITAuto-check passedDevelopment

Install Dsh Create Upgrade Guide

skills CLI
$ npx skills add Zhou-Yujing114514/deepseek-harness-linux --skill dsh-create-upgrade-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Zhou-Yujing114514/deepseek-harness-linux dsh-create-upgrade-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Zhou-Yujing114514/deepseek-harness-linux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/dsh-create-upgrade-guide .claude/skills/dsh-create-upgrade-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dsh-create-upgrade-guide
GitHub stars
120
Token cost
~932 tokens
SKILL.md length
437 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a deepseek-harness change breaks an externally perceptible surface (CLI, profiles, cordis.yml or settings keys, persisted user data, SDK or wire APIs, published package…

  • A deepseek-harness change breaks an externally perceptible surface (CLI
  • SKILL.md covers Scope, Location, Maintenance and Format, plus 1 more section
  • Calls pnpm
  • Persisted user data

What it does

Dsh Create Upgrade Guide is an agent skill from Zhou-Yujing114514/deepseek-harness-linux. Use when a deepseek-harness change breaks an externally perceptible surface (CLI, profiles, cordis.yml or settings keys, persisted user data, SDK or wire APIs, published package entry points), or when changing a surface that an unreleased upgrade guide already covers, to write or update docs/upgrade-guide/v<version/<item/guide.md.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code migrations. It works with DeepSeek. The repository describes itself as: First-class Linux packaging for DeepSeek Harness desktop — AppImage, .deb, .tar.gz for x64/arm64, built by native CI. The licence is MIT.

When your agent uses it

  • A deepseek-harness change breaks an externally perceptible surface (CLI
  • Persisted user data
  • Published package entry points)
  • Changing a surface that an unreleased upgrade guide already covers

Example prompts

  • “/dsh-create-upgrade-guide”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 35a829f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dsh Create Upgrade Guide loads about 932 tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~932

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Zhou-Yujing114514/deepseek-harness-linux at commit 35a829f, republished under its MIT licence (© Zhou-Yujing114514). 437 words, ~932 tokens.

Download SKILL.mdSave it as .claude/skills/dsh-create-upgrade-guide/SKILL.md (or your agent's skills folder).
name
dsh-create-upgrade-guide
description
Use when a deepseek-harness change breaks an externally perceptible surface (CLI, profiles, cordis.yml or settings keys, persisted user data, SDK or wire APIs, published package entry points), or when changing a surface that an unreleased upgrade guide already covers, to write or update docs/upgrade-guide/v<version>/<item>/guide.md.

DSH Create Upgrade Guide

An upgrade guide tells a reader who runs release vT what to change to run the next release. Write it in the change that introduces the break, as soon as the break is recognized; do not defer it to release preparation.

Scope

Write a guide only for breaks that someone outside the repository can observe after upgrading:

  • dsh commands, flags, and profile names;
  • cordis.yml, patch, overlay, and settings keys or their accepted values;
  • persisted user data: Session logs, SQLite stores, and user data directories;
  • TypeScript and Python SDK exports, JSON-RPC, HTTP, and ACP messages;
  • published package names and entry points.

Pre-stable internal APIs whose consumers are all updated in the same change need no guide. A Session-format change still follows type acknowledgements; its guide states only the reader's actions and links that record.

Location

docs/upgrade-guide/v<version>/<item>/guide.md

  • <version> is the version field of the root package.json when you write the guide, for example v0.1.7-rc.2. The guide describes the upgrade from that release to the next one.
  • <item> is a kebab-case name of the changed surface, for example profile-flag-rename.
  • Each item directory holds exactly guide.md, its Chinese counterpart guide.zh.md, and the pairing record guide.i18n.yaml: no index, no attachments.

Maintenance

While the root version is unchanged, the current version directory describes the delta from vT to current master. When a later change touches a surface a guide there covers, update that guide in the same change; delete the guide when the break is reverted. After the version bump, guides in older version directories are frozen; a new break goes into the new version directory. Never write a guide spanning more than one release.

Show full SKILL.md (164 more words)Show less

Format

Start from the upgrade-guide template. verify-upgrade-guides enforces:

  • frontmatter with exactly kind: upgrade-guide and a one-sentence description naming what breaks; add a key only together with its gate check, then backfill every guide;
  • one # title, then exactly the ## Change and ## Migration sections in guide.md, and ## 变更 and ## 迁移 in guide.zh.md, in that order;
  • at most 500 words in guide.md, frontmatter included.

Change states the old and new behavior of the surface and who is affected. Migration lists ordered steps that name exact files, keys, commands, or symbols, and states how to confirm the migration worked.

When a guide needs more than 500 words, the extra text belongs elsewhere: link source files or symbols instead of restating code, move rationale into an Agent Note, and turn repeated mechanical steps into a script or dsh command that the guide invokes.

Follow dsh-prose-standard. Write the Chinese counterpart in the same change under the bilingual pairing rules, then record the pair with pnpm run verify-translation-pairing --write docs/upgrade-guide/v<version>/<item>/guide.md.

Verify

sh
pnpm run verify-upgrade-guides
pnpm run verify-translation-pairing docs/upgrade-guide/v<version>/<item>/guide.md
pnpm run verify-md-links

© Zhou-Yujing114514, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/dsh-create-upgrade-guide of Zhou-Yujing114514/deepseek-harness-linux.

Open the folder on GitHubat commit 35a829f

Compare with similar skills

Dsh Create Upgrade Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dsh Create Upgrade Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dsh Create Upgrade Guide this skillZhou-Yujing114514/deepseek-harness-linux120—~932Automated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT
ast-grep Structural Searchcode-yeongyu/oh-my-openagent70k—~3.3kAutomated safety check: PassMIT
Next Cache Components Adoptionvercel/next.js143k6 repos~8.3kAutomated safety check: PassMIT
Deprecate R Functions and Argumentstidyverse/dplyr5.1k1 repos~1.2kAutomated safety check: PassCustom licence

Similar skills

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • ast-grep Structural Search

    code-yeongyu/oh-my-openagent

    Searches and rewrites code by syntax-tree shape across 25 languages with ast-grep, for codemods, structural queries and YAML lint rules, using a Python wrapper script.

    70k GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces.

    143k GitHub starsUsed in 6 repos~8.3k tokens
    DevelopmentAuto-check passed
  • Walks through deprecating an R function or argument in a package: lifecycle warning, silenced tests, a new snapshot test, documentation badge and NEWS entry.

    5.1k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Rust Path Types

    openinterpreter/openinterpreter

    Rules for choosing Rust types for filesystem paths in new Codex code, covering protocol types, internal use and model tool arguments.

    69k GitHub starsUsed in 2 repos~605 tokens
    DevelopmentAuto-check passed

More from Zhou-Yujing114514/deepseek-harness-linux

All 9 skills in this repo
  • Diagnose Windows Sandbox Acl

    Zhou-Yujing114514/deepseek-harness-linux

    Use on Windows for unexpected DSH sandbox access denials: workspace writes or listing fail, or an ordinarily readable path cannot be read.

    120 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Cordis Plugin Development

    Zhou-Yujing114514/deepseek-harness-linux

    A skill your agent uses when designing, reviewing, adding, enabling, disabling, installing, configuring, or debugging a plugin, bundle, feature, page, panel, tool, or MCP connection in the current…

    120 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check passed
  • Dsh CI Test Reliability

    Zhou-Yujing114514/deepseek-harness-linux

    Design, review, and diagnose DeepSeek Harness tests and fixtures that can fail nondeterministically under CI concurrency, shared host resources, clocks, process-global state, subprocesses, network…

    120 GitHub stars~2.4k tokensUpdated 5 days ago
    Auto-check passed
  • Dsh Find Simplifications

    Zhou-Yujing114514/deepseek-harness-linux

    Find evidence-backed simplifications in DeepSeek Harness code, APIs, configuration, tests, and prose; write or consolidate proposals, identify small inline cleanups, or assess simplifications from…

    120 GitHub stars~2.6k tokensUpdated 5 days ago
    Auto-check passed
  • Dsh Client UI UX

    Zhou-Yujing114514/deepseek-harness-linux

    Design and review DeepSeek Harness client UI changes — visual token discipline, reuse-before-adding, feedback surfaces (toast vs in-place notice vs empty state), overlay and menu safety, platform…

    120 GitHub stars~1.9k tokensUpdated 5 days ago
    Auto-check passed
  • Dsh Code Review

    Zhou-Yujing114514/deepseek-harness-linux

    A skill your agent uses when reviewing a pull request in the deepseek-harness repo — orients the reviewer to this codebase's standards (AGENTS.md conventions, defensive patterns, ADRs, quality…

    120 GitHub stars~2.1k tokensUpdated 5 days ago
    Auto-check passed

Works with

Categories

Questions about Dsh Create Upgrade Guide

What does Dsh Create Upgrade Guide do?

A skill your agent uses when a deepseek-harness change breaks an externally perceptible surface (CLI, profiles, cordis.yml or settings keys, persisted user data, SDK or wire APIs, published package…. Dsh Create Upgrade Guide is an agent skill from Zhou-Yujing114514/deepseek-harness-linux.md.

When should I use Dsh Create Upgrade Guide?

Dsh Create Upgrade Guide fits situations like: A deepseek-harness change breaks an externally perceptible surface (CLI; persisted user data; published package entry points); changing a surface that an unreleased upgrade guide already covers.

How do I install Dsh Create Upgrade Guide in Claude Code?

Run `npx skills add Zhou-Yujing114514/deepseek-harness-linux --skill dsh-create-upgrade-guide -a claude-code`. Or copy the skill folder (.agents/skills/dsh-create-upgrade-guide in Zhou-Yujing114514/deepseek-harness-linux) into .claude/skills/dsh-create-upgrade-guide in your project. Claude Code loads it when a task matches its description.

How do I install Dsh Create Upgrade Guide in Codex?

Run `npx skills add Zhou-Yujing114514/deepseek-harness-linux --skill dsh-create-upgrade-guide -a codex`. Or copy the skill folder (.agents/skills/dsh-create-upgrade-guide in Zhou-Yujing114514/deepseek-harness-linux) into .agents/skills/dsh-create-upgrade-guide in your project. Codex loads it when a task matches its description.

Can I use Dsh Create Upgrade Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Zhou-Yujing114514/deepseek-harness-linux --skill dsh-create-upgrade-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dsh-create-upgrade-guide, .gemini/skills/dsh-create-upgrade-guide, .github/skills/dsh-create-upgrade-guide and .opencode/skills/dsh-create-upgrade-guide in your project.

What does Dsh Create Upgrade Guide need to run?

Going by SKILL.md and its folder, Dsh Create Upgrade Guide needs the command-line tools its instructions call (pnpm). Our summary lists: Python 3.

Does Dsh Create Upgrade Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dsh Create Upgrade Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dsh Create Upgrade Guide use?

Dsh Create Upgrade Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dsh Create Upgrade Guide use?

About 932 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dsh Create Upgrade Guide?

Skills that share tags, products or a category with Dsh Create Upgrade Guide: Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), Migrate Internal Package into Ghost (TryGhost/Ghost, 56k stars), ast-grep Structural Search (code-yeongyu/oh-my-openagent, 70k stars) and Next Cache Components Adoption (vercel/next.js, 143k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dsh Create Upgrade Guide?

Zhou-Yujing114514 (a GitHub user) maintains it in Zhou-Yujing114514/deepseek-harness-linux, which has 120 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 6, 2026.

Source: Zhou-Yujing114514/deepseek-harness-linux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.