Skip to content
Back to search

ruby-skills

MarketplaceWorks with Claude CodeGitHub

Claude Code plugins for Ruby development.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/st0012--ruby-skills/badge.svg)](/listings/st0012--ruby-skills)

HTML

<a href="/listings/st0012--ruby-skills"><img src="/api/listings/st0012--ruby-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

**From terminal:**

claude plugin marketplace add st0012/ruby-skills
claude plugin install ruby-skills@ruby-skills

**From a Claude session:**

/plugin marketplace add st0012/ruby-skills

After the marketplace is added:

/plugin install ruby-skills@ruby-skills

Codex

**From terminal:**

codex plugin marketplace add st0012/ruby-skills
codex plugin add ruby-skills@ruby-skills

The Codex plugin exposes the same Ruby skills through Codex's skill loader. It does not use the Claude Code `SessionStart` hook.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ruby-skills",
  3. "owner": {
  4. "name": "Stan Lo",
  5. "email": "stan001212@gmail.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "ruby-skills",
  10. "source": "./plugins/ruby-skills",
  11. "description": "Ruby version manager detection, authoritative resource map, and test framework reference",
  12. "version": "0.6.0"
  13. }
  14. ]
  15. }
README.md · README · 88 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Ruby Skills
  2. Ruby's ecosystem has many version managers, a rapidly evolving typing and tooling landscape, and documentation scattered across multiple sources.
  3. Ruby Skills helps coding agents navigate each of these — activating the correct Ruby environment, pointing to authoritative docs, and avoiding common test framework pitfalls.
  4. ## Installation
  5. ### Claude Code
  6. **From terminal:**
  7. ```bash
  8. claude plugin marketplace add st0012/ruby-skills
  9. claude plugin install ruby-skills@ruby-skills
  10. ```
  11. **From a Claude session:**
  12. ```bash
  13. /plugin marketplace add st0012/ruby-skills
  14. ```
  15. After the marketplace is added:
  16. ```bash
  17. /plugin install ruby-skills@ruby-skills
  18. ```
  19. ### Codex
  20. **From terminal:**
  21. ```bash
  22. codex plugin marketplace add st0012/ruby-skills
  23. codex plugin add ruby-skills@ruby-skills
  24. ```
  25. The Codex plugin exposes the same Ruby skills through Codex's skill loader. It does not use the Claude Code `SessionStart` hook.
  26. ## What to Expect
  27. After installation, start an agent session in any Ruby project — no configuration needed. The relevant Ruby skills activate automatically.
  28. ### `ruby-version-manager`
  29. Detects your version manager and project Ruby version, then activates it for every shell command. Supports chruby, rbenv, rvm, asdf, mise, rv, and shadowenv.
  30. - Reads `.ruby-version`, `.tool-versions`, `.mise.toml`, or `Gemfile` to determine the required version
  31. - Handles multi-manager environments — prompts you to set a preference if more than one is detected
  32. - Offers to install missing Ruby versions
  33. - Works around Claude Code's non-persistent shell by chaining activation with every command
  34. See the [technical reference](plugins/ruby-skills/skills/ruby-version-manager/README.md) for detection internals.
  35. ### `ruby-resource-map`
  36. Points Claude to authoritative documentation sources so it doesn't hallucinate APIs or rely on outdated references.
  37. - Version-specific docs for Ruby 3.2–4.0 and master
  38. - Core vs bundled vs default gem distinctions
  39. - Ruby typing ecosystem: Sorbet (RBI) and RBS, including Tapioca, Spoom, Steep, and RBS inline comments
  40. - Blocks known-bad sources (ruby-doc.org, apidock.com)
  41. ### `ruby-test-frameworks`
  42. Divergence reference for minitest and test-unit — the two frameworks have deceptively similar APIs with critical naming differences that cause `NoMethodError` at runtime.
  43. - Side-by-side assertion naming mismatches (`assert_raises` vs `assert_raise`, `refute_*` vs `assert_not_*`, etc.)
  44. - CLI flag comparison for test selection (by name, line number, class, pattern)
  45. - Lifecycle differences (`startup`/`shutdown`/`cleanup` in test-unit, `before_setup`/`after_teardown` in minitest)
  46. - Rails-specific aliases that blur the line between the two frameworks
  47. #### Why not RSpec?
  48. RSpec has a distinct API (`describe`/`it`/`expect`) that doesn't overlap with minitest or test-unit. LLMs rarely confuse it with other frameworks, so a divergence reference isn't needed.
  49. ## Acknowledgements
  50. The version manager detection logic is based on [Ruby LSP's VS Code extension](https://github.com/Shopify/ruby-lsp/tree/main/vscode) by Shopify.
  51. ## Contributing
  52. Feedback, use cases, issue reports, and contributions are all welcome on [GitHub](https://github.com/st0012/ruby-skills).
  53. ## License
  54. MIT License - see [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.