Skip to main content
Alison Aquinas logoAlison's LLM Skills Marketplace

rbenv

Included in skill bundleci-cdView on GitHub ↗

Files

SKILL.mdagentsreferences

Install

Install only this skill with npx skills
npx skills add alisonaquinas/llm-ci-dev --skill 'rbenv' -g -y
Install the containing skill bundle
/plugin install ci-cd@llm-skills
Download rbenv-skill.zip
This skill is bundled inside ci-cd. Use npx skills when you only want this skill, or install the bundle once to make every included skill available through the plugin marketplace flow. Browse the full skill bundle repository at github.com/alisonaquinas/llm-ci-dev.

Invoke

Invoke this skill after installation
/ci-cd:rbenv

SKILL.md

name: rbenv description: Manage Ruby versions with rbenv. Use when tasks mention rbenv, Ruby version switching, .ruby-version, or ruby-build.

rbenv

Intent Router

RequestReferenceLoad When
Homebrew install, rbenv-installer, shell integrationreferences/install-and-setup.mdrbenv needs to be installed or shell integration is missing
install/global/local/shell/versions/rehash commandsreferences/command-cookbook.mdSpecific rbenv commands are needed
ruby-build plugin, build from source, RUBY_CONFIGURE_OPTSreferences/ruby-build.mdBuilding or listing installable Ruby versions is the topic
.ruby-version, shell > local > global precedencereferences/project-files.mdProject-level Ruby version pinning or precedence is the topic

Quick Start

# Install Ruby 3.3.0
rbenv install 3.3.0

# Set as global default
rbenv global 3.3.0

# Pin version for a project (writes .ruby-version)
rbenv local 3.3.0

# Verify active version
rbenv version

Core Command Tracks

  • Install Ruby: rbenv install 3.3.0
  • Global default: rbenv global 3.3.0
  • Project pin: rbenv local 3.3.0 (writes .ruby-version)
  • Shell override: rbenv shell 3.2.0 (current shell only)
  • List installed: rbenv versions
  • List available: rbenv install --list
  • Rehash shims: rbenv rehash (run after installing gems with executables)

Safety Guardrails

  • Run rbenv rehash after installing any gem that provides a CLI binary (e.g. bundler, rails).
  • Commit .ruby-version to version control so all contributors use the same Ruby.
  • Do not modify the PATH manually before rbenv init runs — let the shell integration manage shims.
  • Prefer rbenv local over setting RBENV_VERSION manually to keep the version declaration in the repo.

Workflow

  1. Install the target Ruby: rbenv install <version>.
  2. Set global default: rbenv global <version>.
  3. For a project, cd into the directory and run rbenv local <version>.
  4. Confirm with rbenv version and ruby -v.
  5. After bundle install, run rbenv rehash to register new binstubs.
# Troubleshoot: gem binary not found after install, refresh shims
gem install bundler
rbenv rehash
rbenv which bundler

Related Skills

  • rvm — alternative Ruby version manager with built-in gemset support
  • asdf — universal version manager that also handles Ruby

References

← Back to marketplace