SkillHub

deprecate

Deprecate a whole skill, or yank a specific version.

skillhub deprecate marks a skill as deprecated, or yanks a single version. Appending @<version> to the ref yanks that one version; without a version, the whole skill is deprecated. An optional message explains why or points to a replacement.

Synopsis

skillhub deprecate <skill[@version]> [message]

Examples

skillhub deprecate @studio/design-systems/old-skill "Use tokens-workflow instead"
skillhub deprecate @studio/design-systems/tokens-workflow@1.0.0 "Bad release"

JSON output

With --json, the data object is one of:

  • { action: "deprecated", ref, message (string|null) } — a whole-skill deprecation.
  • { action: "yanked", ref, version, reason (string|null), yankedAt } — a single-version yank.

On this page