Ruby's ecosystem has many version managers, a rapidly evolving typing and tooling landscape, and documentation scattered across multiple sources.
These Claude Code plugins help Claude navigate each of these — activating the correct Ruby environment, pointing to authoritative docs, and providing LSP-powered code intelligence.
| Plugin | Purpose |
|---|---|
| ruby-skills | Version manager detection and authoritative resource map |
| ruby-lsp | Ruby LSP integration for code intelligence |
From terminal:
claude plugin marketplace add st0012/ruby-skills
# Install both for the full experience, or just ruby-skills for version management without LSP
claude plugin install ruby-skills@ruby-skills
claude plugin install ruby-lsp@ruby-skillsFrom a Claude session:
/plugin marketplace add st0012/ruby-skills
/plugin install ruby-skills@ruby-skills
/plugin install ruby-lsp@ruby-skillsAfter installation, start a Claude Code session in any Ruby project — no configuration needed. The plugins activate automatically.
- Detects your version manager and project Ruby version, then activates it for all commands
- Supports chruby, rbenv, rvm, asdf, mise, rv, and shadowenv
- Provides Claude with a curated map of authoritative documentation sources, including version-specific docs and the references about the Ruby typing ecosystem
See the technical reference for detection internals.
Builds on the ruby-skills plugin to provide Ruby LSP integration — hover documentation, go-to-definition, and diagnostics.
Note
Requires ENABLE_LSP_TOOL=1 environment variable due to a known Claude Code issue. See Known Issues.
- Auto-installs the ruby-lsp gem if missing
- Supports
.rb,.erb,.rake,.gemspec,.ru, andRakefile - See plugins/ruby-lsp/README.md for details
The version manager detection logic is based on Ruby LSP's VS Code extension by Shopify.
Feedback, use cases, issue reports, and contributions are all welcome on GitHub.
MIT License - see LICENSE for details.