Ruby Skills
st0012/ruby-skills
Gerenciamento automático de versão Ruby e documentação autorizada para agentes de código
Ver no GitHubSkill para Claude Code que facilita desenvolvimento Ruby ao gerenciar automaticamente versões, apontar para documentação autorizada e resolver armadilhas de frameworks de teste. Ativa ambientes Ruby sem configuração manual e evita alucinações sobre APIs.
Instalação
npx convez-ai st0012/ruby-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento de projetos Ruby em equipes com múltiplos gerenciadores de versão
- Evitar erros entre minitest e test-unit ao escrever testes
- Acessar documentação correta para Ruby 3.2-4.0 sem confundir com fontes desatualizadas
- Ativar ambiente Ruby correto automaticamente em sessões Claude Code
Veredito

Skill bem-focada que resolve dores reais do desenvolvimento Ruby — gerenciamento de versão fragmentado e confusão entre APIs de frameworks similares. Prático e sem overhead, mas nicho específico para quem trabalha com Ruby.
README
A tradução para o português deste README ainda está na fila.
Ruby Skills
Ruby's ecosystem has many version managers, a rapidly evolving typing and tooling landscape, and documentation scattered across multiple sources.
Ruby Skills helps coding agents navigate each of these — activating the correct Ruby environment, pointing to authoritative docs, and avoiding common test framework pitfalls.
Installation
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 to Expect
After installation, start an agent session in any Ruby project — no configuration needed. The relevant Ruby skills activate automatically.
ruby-version-manager
Detects your version manager and project Ruby version, then activates it for every shell command. Supports chruby, rbenv, rvm, asdf, mise, rv, and shadowenv.
- Reads
.ruby-version,.tool-versions,.mise.toml, orGemfileto determine the required version - Handles multi-manager environments — prompts you to set a preference if more than one is detected
- Offers to install missing Ruby versions
- Works around Claude Code's non-persistent shell by chaining activation with every command
See the technical reference for detection internals.
ruby-resource-map
Points Claude to authoritative documentation sources so it doesn't hallucinate APIs or rely on outdated references.
- Version-specific docs for Ruby 3.2–4.0 and master
- Core vs bundled vs default gem distinctions
- Ruby typing ecosystem: Sorbet (RBI) and RBS, including Tapioca, Spoom, Steep, and RBS inline comments
- Blocks known-bad sources (ruby-doc.org, apidock.com)
ruby-test-frameworks
Divergence reference for minitest and test-unit — the two frameworks have deceptively similar APIs with critical naming differences that cause NoMethodError at runtime.
- Side-by-side assertion naming mismatches (
assert_raisesvsassert_raise,refute_*vsassert_not_*, etc.) - CLI flag comparison for test selection (by name, line number, class, pattern)
- Lifecycle differences (
startup/shutdown/cleanupin test-unit,before_setup/after_teardownin minitest) - Rails-specific aliases that blur the line between the two frameworks
Why not RSpec?
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.
Acknowledgements
The version manager detection logic is based on Ruby LSP's VS Code extension by Shopify.
Contributing
Feedback, use cases, issue reports, and contributions are all welcome on GitHub.
License
MIT License - see LICENSE for details.