Agent Note: Bundled dsh badge skill

Status: implemented Archived: 2026-08-22

English | 中文

Problem

The Cordis tutorial uses an official “powered by dsh” badge across its pages, but the shipped CLI has no reusable instructions or explicit opt-in provider for applying the same attribution elsewhere.

Decision

@deepseek-ai/dsh-skill-badge is a native Cordis plugin that registers one immutable bundled provider on ctx.skills. The provider owns the dsh-badge summary, instruction body, and PNG resource base; dsh-tool-skill remains the sole owner of model-facing catalog and loader rendering.

The shipped CLI composition declares skill-badge as disabled. Enabling that existing row is the explicit opt-in; disabled installations advertise no badge skill and gain no model-visible content.

The provider uses the bundled rank after project, custom, and user filesystem sources, so a user-owned dsh-badge definition can override it through the ordinary registry precedence contract. Provider disposal removes the contribution through the registry-owned effect.

Alternatives considered

Mount packaged files through dsh-skill-filesystem. Rejected because filesystem discovery, parsing, and watching add lifecycle machinery that an immutable single-skill provider does not need.

Consequences

The badge instructions and source PNG are versioned with DSH and resolve through a packaged directory resource base. The provider has no configuration surface. Package tests pin provider lifecycle and the official PNG bytes, while a keyless assembled-application snapshot pins the enabled catalog and loaded skill body.