SkillsAdd

ivan-magda/claude-superpowers · Archived

releasing-plugin-versions

Use when releasing a new plugin version, bumping versions, creating git tags, or publishing GitHub releases for this marketplace

First seen Mar 20, 2026

Installation

$ npx skills add ivan-magda/claude-superpowers --skill releasing-plugin-versions
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

swift-docc-comments Same source · more installs
ivan-magda/claude-superpowers

Use when writing or enhancing Swift documentation comments for DocC generation, adding inline d…

2 installs
swift-docc-github-pages Same source
ivan-magda/claude-superpowers

Use when setting up DocC documentation for a Swift package, deploying to GitHub Pages, or encou…

1 installs
swift-package-demo Same source
ivan-magda/claude-superpowers

Use when creating demo GIFs for Swift package READMEs, recording iOS simulator videos, or setti…

1 installs
swift-6-migration Same source
ivan-magda/claude-superpowers

Use when encountering Swift 6 concurrency errors, Sendable conformance warnings, actor isolatio…

1 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

releasing-macos-apps Similar name
jamesrochabrun/skills

Create notarized macOS app releases with Sparkle auto-updates, DMG installers, and GitHub relea…

191 installs

Also in this package

Other skills from ivan-magda/claude-superpowers.

npx skills add ivan-magda/claude-superpowers
swift-docc-comments 2 swift-docc-github-pages 1 swift-package-demo 1 swift-6-migration 1

Browse all from ivan-magda/claude-superpowers

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 6
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,008 B
  • docs SUMMARY.md 161 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Releasing Plugin Versions

Critical Distinction

metadata.version ≠ plugin version. These are DIFFERENT things:

Field What It Tracks When to Update
plugins[].version Individual plugin version Every plugin release
metadata.version Marketplace catalog structure Adding/removing plugins ONLY

Common mistake: Thinking metadata.version should "stay in sync" with plugin versions. It should NOT.

Plugin Version Locations (Update ALL 4)

When releasing a plugin (e.g., swift 1.2.0 → 1.3.0):

  1. plugins/swift/.claude-plugin/plugin.json → "version": "1.3.0"
  2. .claude-plugin/marketplace.json → plugins[].version: "1.3.0"
  3. plugins/swift/README.md → Version section: 1.3.0
  4. README.md (root) → Available Plugins table: 1.3.0

Release Commands

# 1. Stage changes
git add -A

# 2. Commit
git commit -m "Release swift v1.3.0

- Description of changes"

# 3. Tag (format: v1.3.0, NOT swift-v1.3.0)
git tag v1.3.0

# 4. Push
git push && git push origin v1.3.0

# 5. GitHub release
gh release create v1.3.0 --title "v1.3.0" --notes "## Changes

- Change 1
- Change 2

**Full Changelog**: https://github.com/OWNER/REPO/compare/v1.2.0...v1.3.0"

Tag Format

Use v1.3.0, NOT swift-v1.3.0. Check existing tags:

git tag --sort=-v:refname | head -5

When NOT to Update metadata.version

  • Releasing a new plugin version ❌
  • Fixing plugin bugs ❌
  • Adding features to existing plugins ❌
  • Updating plugin documentation ❌

When TO Update metadata.version

  • Adding a NEW plugin to the catalog ✓
  • Removing a plugin from the catalog ✓
  • Changing marketplace owner/name ✓