Claude Code Plugins

Community-maintained marketplace

Feedback

project-release

@serejaris/ris-claude-code
32
0

Releases ris-claude-code project - handles versioning, changelog, READMEs, tags, and GitHub releases. Use when releasing a new version or when asked to release.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name project-release
description Releases ris-claude-code project - handles versioning, changelog, READMEs, tags, and GitHub releases. Use when releasing a new version or when asked to release.

Project Release

Releases ris-claude-code with semantic versioning, changelog updates, and GitHub releases.

Pre-release Checklist

Copy and check off:

- [ ] All changes committed
- [ ] Version bump determined
- [ ] READMEs need update? (only if skills list changed)
- [ ] All skill folders have SKILL.md + READMEs

Version Rules

Change Bump Example
New skill/component MINOR 1.5.1 → 1.6.0
Update existing skill PATCH 1.5.1 → 1.5.2
Bug fix, docs only PATCH 1.5.1 → 1.5.2

Get current version:

git describe --tags --abbrev=0

Files Decision Matrix

Condition CHANGELOG READMEs
Any release Update Check below
Skills list changed (add/remove) Update Update both
Skills list unchanged Update Skip

Release Workflow

Step 1: Update CHANGELOG.md

## [X.Y.Z] - YYYY-MM-DD

### Added
- New feature

### Changed
- Updated feature

### Fixed
- Bug fix

Update comparison links at bottom:

[Unreleased]: https://github.com/serejaris/ris-claude-code/compare/vX.Y.Z...HEAD
[X.Y.Z]: https://github.com/serejaris/ris-claude-code/compare/vPREV...vX.Y.Z

Step 2: Update READMEs (if needed)

Only if skills list changed. Update both:

  • README.md (English)
  • README.ru.md (Russian)

Step 3: Commit

git add -A && git commit -m "docs: update changelog for vX.Y.Z"

Step 4: Tag

git tag -a vX.Y.Z -m "Release vX.Y.Z"

Step 5: Push

git push && git push --tags

Step 6: GitHub Release

gh release create vX.Y.Z \
  --title "vX.Y.Z — Short Description" \
  --notes "$(cat <<'EOF'
## Added/Changed
- Item 1
- Item 2

**Full Changelog**: https://github.com/serejaris/ris-claude-code/compare/vPREV...vX.Y.Z
EOF
)"

Post-release Verification

- [ ] Tag visible: git tag -l | tail -1
- [ ] Release on GitHub: gh release view vX.Y.Z
- [ ] CHANGELOG links work

Common Mistakes

Mistake Fix
Forgot CHANGELOG links Add [X.Y.Z] comparison link at bottom
Wrong version bump New skill = MINOR, update = PATCH
READMEs updated unnecessarily Only update if skills LIST changed
Missing release notes Use template above
Forgot to push tags git push --tags separately