From rails-agent-skills
Prepares Rails engine gem releases: generates CHANGELOG entries and upgrade notes, updates version constants, verifies gemspec metadata, confirms test suite passes, sequences build and publish.
npx claudepluginhub igmarin/rails-agent-skills --plugin rails-agent-skillsThis skill uses the workspace's default tool permissions.
Use this skill when the task is to ship a Rails engine as a gem or prepare a new version.
Analyzes Rails apps to assess upgrades to latest version, summarizing official guides, railsdiff.org file changes, upgrade types, and JS dependencies.
Analyzes Rails applications and generates upgrade reports with breaking changes, deprecations, and step-by-step migration guides from 2.3 to 8.1. Use for incremental upgrades and version queries.
Plans and executes software releases: inventories git changes, applies semantic versioning, generates changelog and release notes, updates files, creates tags, and publishes to GitHub. Use before new versions.
Share bugs, ideas, or general feedback.
Use this skill when the task is to ship a Rails engine as a gem or prepare a new version.
DO NOT release without updating CHANGELOG and version file.
| Bump | When to use | Action |
|---|---|---|
| Patch | Bug fixes and internal changes without public behavior breakage | Update version constant, document under Fixed |
| Minor | Backward-compatible features and new extension points | Update version constant, document under Added/Changed |
| Major | Breaking changes to API, setup, routes, migrations, config, or supported framework versions | Update version constant, document under Changed/Deprecated; write explicit upgrade notes |
If the engine requires host changes during upgrade, document them explicitly even if the version bump is minor.
bundle exec rspec. Fix all failures before proceeding.module MyEngine; VERSION = "1.2.0"; end in lib/my_engine/version.rb.gem build *.gemspec && gem push --dry-run *.gem. Verify contents.gem push *.gem.## [1.2.0] - 2024-03-15
### Added
- `widget_count` config option to limit dashboard widgets (default: 10).
### Changed
- Minimum Rails version is now 7.0.
See assets/examples.md for a full changelog entry and upgrade note template.
Load these files only when their specific content is needed:
When asked to prepare a release, produce a release summary ready for team lead review, with code blocks for all file changes. Required deliverables:
lib/<engine>/version.rbbundle exec rspec| Skill | When to chain |
|---|---|
| rails-engine-docs | When updating README, setup instructions, or API docs for the release |
| rails-engine-compatibility | When verifying Rails/Ruby version support or deprecation impact |
| rails-engine-testing | When ensuring tests pass before release and match documented behavior |