Claude Ruby Plugins
A Claude Code marketplace providing plugins for Ruby development.
Installation
Add this marketplace to Claude Code:
/plugin marketplace add stevegeek/claude-ruby-plugins
Or add to your project's .claude/settings.json:
{
"extraKnownMarketplaces": [
"stevegeek/claude-ruby-plugins"
]
}
Then browse and install plugins:
/plugin
Available Plugins
- ruby-rbs - RBS type signature writing, reviewing, and maintenance
ruby-rbs
Skills, commands, and agents for writing Ruby RBS type signatures - inline annotations, standalone .rbs files, and type maintenance.
What is RBS?
RBS is Ruby's official type signature language, introduced with Ruby 3.0. It describes the structure of Ruby programs—classes, modules, methods, and their types—enabling static type checking with tools like Steep.
Installation
/plugin install ruby-rbs@stevegeek-marketplace
Or in .claude/settings.json:
{
"enabledPlugins": {
"ruby-rbs@stevegeek-marketplace": true
}
}
Agents
rbs-creator
Writes RBS type signatures for an entire codebase. Asks whether you want inline or standalone RBS, then works methodically through all Ruby files, setting up Steep, writing signatures, and validating as it goes.
rbs-maintainer
Validates and maintains existing RBS signatures. Runs rbs validate, steep check, finds gaps, and fixes issues.
rbs-reviewer
Critically reviews RBS signatures for quality: suggests generics, replaces untyped, recommends supertypes/interfaces.
rbs-to-inline
Converts standalone .rbs signature files into inline RBS annotations embedded in Ruby source files. Use when migrating from standalone to inline RBS approach. Validates the conversion by comparing generated signatures against originals, then backs up the original .rbs files.
Commands
/write-rbs <path>
Write standalone RBS signatures for Ruby files. Analyzes code, finds tests, optionally traces types, and creates sig/*.rbs files.
/write-inline-rbs <path>
Add inline RBS annotations to Ruby files using rbs-inline comment syntax.
/convert-rbs-to-inline <rbs_file_or_pattern>...
Convert standalone .rbs files to inline RBS annotations. Supports multiple files and glob patterns. Validates conversions and backs up originals to .rbs.bak.
Skill
The ruby-rbs skill provides comprehensive RBS knowledge. It's easier to use a command or agent, but you can load the skill directly by asking Claude to use its RBS skill.
Scripts
Type Tracer
Runtime tool that instruments code execution to discover actual types:
ruby plugins/ruby-rbs/scripts/type_tracer.rb -c 'MyClass' -f json test/my_test.rb
RBS Comparator
Compare hand-written RBS files with generated ones (from rbs-inline) to verify consistency:
# Compare two specific files
bundle exec ruby scripts/compare_rbs.rb sig/user.rbs sig/generated/user.rbs
# Compare directories
bundle exec ruby scripts/compare_rbs.rb --dir sig/ sig/generated/
# JSON output for programmatic use
bundle exec ruby scripts/compare_rbs.rb --json sig/user.rbs sig/generated/user.rbs
# Strict mode (parameter names matter)
bundle exec ruby scripts/compare_rbs.rb --strict-param-names sig/user.rbs sig/generated/user.rbs
By default, parameter names are ignored (e.g., (String name) == (String)). Use --strict-param-names for exact matching.
Quick Examples
Inline RBS (in Ruby files)
# rbs_inline: enabled
class User
attr_reader :name #: String
attr_reader :email #: String?
#: (String, ?String?) -> void
def initialize(name, email = nil)
@name = name
@email = email
end
end
Standalone RBS (separate files)
# sig/user.rbs
class User
attr_reader name: String
attr_reader email: String?
def initialize: (String, ?String?) -> void
end
Acknowledgments
License
Unlicense
stevegeek