releasing-a-version
Use when releasing, cutting, tagging, or shipping a new version of one or more plugins in the svd-agent-skills marketplace - bumping plugin.json, rolling the CHANGELOG [Unreleased] block into a dated version header, committing on main, cutting a per-plugin annotated <plugin>-vX.Y.Z tag, and publishing its GitHub release. Specific to the agent-skills repo.
Target: Software development & testing. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Releasing a version
Each plugin under plugins/ / is versioned on its own, so each released plugin gets its own commit and its own tag. Every push to main ships to users at once (distribution is by commit SHA); the version and CHANGELOG record what shipped. 1. Pick plugins and bumps. For each plugin, read the ## [Unreleased] section of its CHANGELOG.md and the commits since its last tag (git tag --list ' -v', then git log ..HEAD -- plugins/ ). Release the plugins with unreleased changes, unless the user named others. The Unreleased bullets decide the semver bump: MAJOR for a breaking change to output, schema or CLI; MINOR for anything additive; PATCH for fixes, docs and refactors. 2. Run git status. The release commits should hold only the version bump, so if unrelated changes are present, ask the user how to handle them. Run each plugin's smoke test if it has one (find plugins/ -name smoketest.py). When the plugin has hooks/hooks.json (a mod), run claude plugin validate plugins/ and claude plugin test plugins/ . For every plugin you release, run the claude.ai directory checker, python3 tools/checkdirectoryrules.py release plugins/ --fail-on hold, and once its smoke test, python3 tools/smoketestdirecto
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- svd/agent-skills
- Source file
- .claude/skills/releasing-a-version/SKILL.md
- Fixed revision
- cb47e43decd9132b8b9ffc29a43960cc5724435e
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: svd/agent-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-11T00:00:19.045Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.