plugin-runtime-debug SKILL.md skillB

plugin-runtime-debug 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.

Install it, pinned
mdr add oh-my-dsh/dsh-plugin-upgrade-skill/plugin-runtime-debug@git:20260924.a44dda9

Pins git:20260924.a44dda9 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
oh-my-dsh/dsh-plugin-upgrade-skill
Path
skills/plugin-runtime-debug/SKILL.md
Versions recorded
6
Latest version
git:20260924.a44dda9, committed Sep 24, 2026
First version recorded
Sep 2, 2026
Size
12,447 bytes
Repository stars
317
License
MIT

Use when an installed DSH Web plugin misbehaves only at runtime in the browser — paste/attachment/composer features that work once then fail, chips or panels showing stale placeholder state, update chips claiming the wrong version, a surface working in one browser engine but not another — and the fix must be diagnosed against the exact host API semantics rather than guessed from names. Also use when reviewing a plugin's calls into input-machine or facade verbs…

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

# Debug DSH Web Plugin Runtime Behavior

External Web plugins call host client APIs whose contracts live in the DSH
source tree, not in the plugin's own types. When behavior diverges from
intent at runtime, the failure is almost always a misread contract — and the
diagnosis must come from the host source, never from the API's name.

## The standing rule: read the verb's contract in the host source first

Before changing any call into a host API, open the implementing package in
the DSH source checkout (`~/.dsh/source/current`, or the vendored copy) and
read the actual method — its doc comment, its guards, and the types it
compares against. Repeat for every value the plugin passes. Four questions
cover most incidents:

1. **Which text does an offset count into?** When a verb takes a span or an
   offset, find out what string those numbers index. Published snapshot
   fields and internal editor projections are not always the same string; a
   plugin that feeds one representation's offsets into a verb whose guard
   compares against another representation fails silently — the call returns
   `false` or no-ops, nothing throws.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add oh-my-dsh/dsh-plugin-upgrade-skill/plugin-runtime-debug@sha256:40e43b5efa1f8935

The line at the top of this page pins the label git:20260924.a44dda9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Sep 2, 2026 and Sep 24, 2026, about one every 4 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20260924.a44dda9 latest2026-09-24 a44dda9 12,447 BB view · diff
git:20260922.0a913692026-09-22 0a91369 12,186 BB view · diff
git:20260905.853193b2026-09-05 853193b 9,749 BB view · diff
git:20260904.44d3e192026-09-04 44d3e19 8,172 BB view · diff
git:20260904.5419f332026-09-04 5419f33 6,937 BA view · diff
git:20260902.7d33bf42026-09-02 7d33bf4 5,032 BA view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12447 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

oh-my-dsh/dsh-plugin-upgrade-skill · 317 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qyxgchwf4dz3fshj
GET https://markdownregistry.com/api/v1/resolve?ref=oh-my-dsh/dsh-plugin-upgrade-skill/plugin-runtime-debug
GET https://markdownregistry.com/api/v1/blob/40e43b5efa1f893579e4ec7dcfcb566d1f538993d0261339beb864a7259a68bf

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

plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S1-static-scan/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S10-paste-rename-and-version-chip/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S11-mermaid-lazyload-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S12-global-upgrade-ebusy-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S13-peer-range-vs-runtime/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S14-link-install-lock-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S15-slot-error-boundary-crash/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S16-self-host-upgrade-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S17-external-ui-plugin-onboarding-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S18-terminal-sprite-render-trap/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S19-phantom-update-stale-host/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars
plugin-upgrade SKILL.md skill
oh-my-dsh/dsh-plugin-upgrade-skill · benchmark/results/artifacts/2026-10-21-minimax-m3.1-flash-s1-s24-r1/skill/S2-negative-scan/skills/plugin-upgrade/SKILL.md · Use for DSH plugin compatibility, migration, upgrade, regression, or post-upgrade diagnosis, including read-only review…
git:20261021.6e63ed5 · audit A · 317 stars

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

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