CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 42 public AI agent skills for Ruby on Rails development, plus 5 callable workflow skills. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.

97

Quality

97%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

SKILL.mdskills/engines/rails-engine-release/

name:
rails-engine-release
license:
MIT
description:
Use when preparing a Rails engine gem release. Generates CHANGELOG.md entries, produces step-by-step upgrade notes for host apps, sets semantic version constants, verifies gemspec metadata, confirms test suite passes, and sequences gem build and publish commands. Trigger words: version bump, changelog, deprecation, gemspec, upgrade, migration guide, release, publish gem, ship gem, verify gemspec, test suite.

Rails Engine Release

Use this skill when the task is to ship a Rails engine as a gem or prepare a new version.

HARD-GATE

DO NOT release without updating CHANGELOG and version file.

Versioning & Quick Reference

BumpWhen to useAction
PatchBug fixes and internal changes without public behavior breakageUpdate version constant, document under Fixed
MinorBackward-compatible features and new extension pointsUpdate version constant, document under Added/Changed
MajorBreaking changes to API, setup, routes, migrations, config, or supported framework versionsUpdate 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.

Release Order

  1. Confirm scope and compatibility impact — is this patch, minor, or major?
  2. Run full test suite: bundle exec rspec. Fix all failures before proceeding.
  3. Set the version bump — update the version constant once: module MyEngine; VERSION = "1.2.0"; end in lib/my_engine/version.rb.
  4. Update changelog and upgrade notes.
  5. Verify gemspec metadata and dependencies match tested Rails/Ruby versions.
  6. Dry-run the gem build: gem build *.gemspec && gem push --dry-run *.gem. Verify contents.
  7. Confirm installation docs and README match the release — update if needed.
  8. Publish: gem push *.gem.

Changelog Guidelines

  • Document user-visible changes, not commits; group by Added/Changed/Fixed/Deprecated.
  • For deprecations, document removal plan and replacement; keep deprecated code for at least one minor cycle.

Examples

## [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.

Extended Resources (Progressive Disclosure)

Load these files only when their specific content is needed:

Output Style

When asked to prepare a release, produce a release summary ready for team lead review, with code blocks for all file changes. Required deliverables:

  1. Version bump recommendation — patch/minor/major with explicit reasoning
  2. Version constant — updated lib/<engine>/version.rb
  3. CHANGELOG entries — under Added/Changed/Fixed/Deprecated headers
  4. Upgrade notes — host app steps (config, migrations, dependencies)
  5. Gemspec verification — metadata, files, and dependency ranges confirmed
  6. Test suite status — pass/fail result of bundle exec rspec
  7. Release blockers — open issues, or explicitly "No blockers"

Integration

SkillWhen to chain
rails-engine-docsWhen updating README, setup instructions, or API docs for the release
rails-engine-compatibilityWhen verifying Rails/Ruby version support or deprecation impact
rails-engine-testingWhen ensuring tests pass before release and match documented behavior

skills

engines

rails-engine-release

EXAMPLES.md

SKILL.md

README.md

tile.json