Agent skill

Ruby Idioms

by irahardianto in irahardianto/awesome-agv

Modern Ruby (3.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing.

MITAuto-check passedBackend & APIs

Install Ruby Idioms

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/ruby-idioms .claude/skills/ruby-idioms && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .claude/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/ruby-idioms .agents/skills/ruby-idioms && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .agents/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/ruby-idioms .cursor/skills/ruby-idioms && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .cursor/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/irahardianto/awesome-agv.git --path .agents/skills/ruby-idioms

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/ruby-idioms .gemini/skills/ruby-idioms && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .gemini/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/ruby-idioms .github/skills/ruby-idioms && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .github/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add irahardianto/awesome-agv --skill ruby-idioms -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install irahardianto/awesome-agv ruby-idioms --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/irahardianto/awesome-agv.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/ruby-idioms .opencode/skills/ruby-idioms && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "ruby-idioms" agent skill from https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/ruby-idioms into .opencode/skills/ruby-idioms/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ruby-idioms", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: ruby-idioms
GitHub stars: 157
Token cost: ~792 tokens
SKILL.md length: 183 words
Files: 1
Skills in repo: 34
Repo updated: Oct 5, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Modern Ruby (3.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing.

Works in 3 steps: Pattern matching → Endless methods for simple accessors → Data class (3.2+) for immutable value…
Reviewing Ruby scripts
Calls bundle
Tasks that involve Backend development

What it does

Ruby Idioms is an agent skill from irahardianto/awesome-agv. Modern Ruby (3.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing. Use when writing, modifying, or reviewing Ruby scripts, gems, or business logic. Pair with rails-idioms for Rails applications.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Backend development. It works with Ruby. The repository describes itself as: Comprehensive sets of standards and practices designed to elevate the capabilities of AI coding agents. The licence is MIT.

When your agent uses it

Reviewing Ruby scripts
Tasks that involve Backend development

Example prompts

“/ruby-idioms”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Pattern matching
Endless methods for simple accessors
Data class (3.2+) for immutable value objects

What it can do on your machine

Read from SKILL.md and the folder at commit 9e997ba. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- bundle
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ruby Idioms loads about 792 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 183 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~67
When it runs · the whole SKILL.md, loaded when a task matches: ~792

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from irahardianto/awesome-agv at commit 9e997ba, republished under its MIT licence (© irahardianto). 183 words, ~792 tokens.

Download SKILL.mdSave it as .claude/skills/ruby-idioms/SKILL.md (or your agent's skills folder).

name: ruby-idioms
description: Modern Ruby (3.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing. Use when writing, modifying, or reviewing Ruby scripts, gems, or business logic. Pair with rails-idioms for Rails applications.

Ruby Idioms and Patterns

Ruby rewards expressiveness, convention, and developer happiness. Modern Ruby (3.x) favors pattern matching, Ractor for concurrency, and strict typing via Sorbet/RBS. Idiomatic Ruby = readable, tested, convention-following.

Scope: Ruby coding idioms. Test naming: .agents/rules/testing-strategy.md. Logging: @.agents/skills/logging-implementation/SKILL.md.

Modern Ruby Features (3.x)

Pattern matching:

ruby

case result
in { status: :success, data: Task => task }
  render json: task
in { status: :not_found, id: String => id }
  render json: { error: "Task #{id} not found" }, status: :not_found
end

Endless methods for simple accessors:

ruby

def full_name = "#{first_name} #{last_name}"

Data class (3.2+) for immutable value objects:

ruby

TaskResult = Data.define(:task, :status)
result = TaskResult.new(task: task, status: :created)

Error Handling

Domain exception hierarchies:

ruby

class DomainError < StandardError; end

class NotFoundError < DomainError
  attr_reader :resource, :resource_id
  def initialize(resource, resource_id)
    @resource = resource
    @resource_id = resource_id
    super("#{resource} '#{resource_id}' not found")
  end
end

rescue specific exceptions — never bare rescue.
Use ensure for cleanup — equivalent to finally.

Naming

snake_case for methods, variables, file names.
PascalCase for classes, modules.
UPPER_SNAKE_CASE for constants.
? suffix for boolean queries: active?, valid?.
! suffix for destructive or dangerous methods: save!, delete!.

Testing

RSpec (preferred) or Minitest:

ruby

RSpec.describe TaskService do
  describe '#create' do
    it 'creates a task with valid attributes' do
      task = service.create(title: 'Test', priority: :high)
      expect(task.title).to eq('Test')
    end

    it 'raises ValidationError for blank title' do
      expect { service.create(title: '', priority: :high) }
        .to raise_error(ValidationError)
    end
  end
end

let for lazy setup, before for eager setup.
Factory Bot for test data — never fixtures for complex models.

Formatting and Static Analysis

Tool	Purpose	Command
RuboCop	Formatting + linting	`rubocop --autocorrect`
Sorbet	Type checking	`srb tc`
Brakeman	Security scanning	`brakeman --no-pager`
`bundle audit`	CVE scanning	`bundle audit check --update`

Code Idioms and Conventions .agents/rules/code-idioms-and-conventions.md
Testing Strategy .agents/rules/testing-strategy.md
Error Handling Principles .agents/rules/error-handling-principles.md

Files

Just SKILL.md in .agents/skills/ruby-idioms of irahardianto/awesome-agv.

Open the folder on GitHubat commit 9e997ba

Compare with similar skills

Ruby Idioms next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ruby Idioms compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Ruby Idioms this skillirahardianto/awesome-agv	157	—	~792	Automated safety check: Pass	MIT	3 days ago
Antipattern Preventiondoorkeeper-gem/doorkeeper	5.5k	—	~1.1k	Automated safety check: Pass	MIT	yesterday
Gumroad Prod Consoleantiwork/gumroad	9.8k	—	~2.9k	Automated safety check: Notes	MIT	today
Backfill Event Datarubyevents/rubyevents	569	—	~2.8k	Automated safety check: Pass	None	today
Dhhmarckohlbrugge/37signals-skills	724	—	~2.2k	Automated safety check: Pass	None	4 mo ago
Ruby Version Managerst0012/ruby-skills	125	—	~1.3k	Automated safety check: Pass	MIT	3 mo ago

Similar skills

Antipattern Prevention
doorkeeper-gem/doorkeeper
Avoid common Ruby and Rails antipatterns that degrade maintainability and performance.
5.5k GitHub stars~1.1k tokensUpdated yesterday
Backend & APIsAuto-check passed
Gumroad Prod Console
antiwork/gumroad
Execute read-only Ruby/Rails commands against Gumroad's production database for debugging and investigation.
9.8k GitHub stars~2.9k tokensUpdated today
DevelopmentAuto-check: notes
Backfill Event Data
rubyevents/rubyevents
Add or backfill RubyEvents conference data for an event from its website — involvements (organizers/MCs), sponsors, venue + hotels, schedule, talk running order, and speaker GitHub/Twitter handles.
569 GitHub stars~2.8k tokensUpdated today
Backend & APIsAuto-check passed
Dhh
marckohlbrugge/37signals-skills
Review Ruby/Rails code like DHH would - direct, opinionated, allergic to over-engineering.
724 GitHub stars~2.2k tokensUpdated 4 mo ago
DevelopmentAuto-check passed
Ruby Version Manager
st0012/ruby-skills
Use at session start for Ruby projects (Gemfile, .ruby-version, or .tool-versions present).
125 GitHub stars~1.3k tokensUpdated 3 mo ago
Backend & APIsAuto-check passed
Upgrade Rails
RailsEventStore/ecommerce
Upgrade Rails framework to a newer version following the smooth upgrade methodology
507 GitHub stars~976 tokensUpdated 17 days ago
Backend & APIsAuto-check passed

Questions about Ruby Idioms

What does Ruby Idioms do?

Modern Ruby (3.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing. Ruby Idioms is an agent skill from irahardianto/awesome-agv.x) idioms: pattern matching, keyword arguments, immutable data structures, error hierarchies, and RSpec testing.

When should I use Ruby Idioms?

Ruby Idioms fits situations like: reviewing Ruby scripts; tasks that involve Backend development.

How do I install Ruby Idioms in Claude Code?

Run `npx skills add irahardianto/awesome-agv --skill ruby-idioms -a claude-code`. Or copy the skill folder (.agents/skills/ruby-idioms in irahardianto/awesome-agv) into .claude/skills/ruby-idioms in your project. Claude Code loads it when a task matches its description.

How do I install Ruby Idioms in Codex?

Run `npx skills add irahardianto/awesome-agv --skill ruby-idioms -a codex`. Or copy the skill folder (.agents/skills/ruby-idioms in irahardianto/awesome-agv) into .agents/skills/ruby-idioms in your project. Codex loads it when a task matches its description.

Can I use Ruby Idioms in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add irahardianto/awesome-agv --skill ruby-idioms -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ruby-idioms, .gemini/skills/ruby-idioms, .github/skills/ruby-idioms and .opencode/skills/ruby-idioms in your project.

What does Ruby Idioms need to run?

Going by SKILL.md and its folder, Ruby Idioms needs the command-line tools its instructions call (bundle).

Does Ruby Idioms access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ruby Idioms safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ruby Idioms use?

Ruby Idioms is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ruby Idioms use?

About 792 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ruby Idioms?

Skills that share tags, products or a category with Ruby Idioms: Antipattern Prevention (doorkeeper-gem/doorkeeper, 5.5k stars), Gumroad Prod Console (antiwork/gumroad, 9.8k stars), Backfill Event Data (rubyevents/rubyevents, 569 stars) and Dhh (marckohlbrugge/37signals-skills, 724 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ruby Idioms?

irahardianto (a GitHub user) maintains it in irahardianto/awesome-agv, which has 157 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 5, 2026.

Source: irahardianto/awesome-agv on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Ruby Idioms

Install Ruby Idioms

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Ruby Idioms and Patterns

Modern Ruby Features (3.x)

Error Handling

Naming

Testing

Formatting and Static Analysis

Files

Compare with similar skills

Similar skills

Antipattern Prevention

Gumroad Prod Console

Backfill Event Data

Dhh

Ruby Version Manager

Upgrade Rails

More from irahardianto/awesome-agv

Distinctive Frontend Design Builder

Perf Optimization

Angular Idioms and Patterns

CI/CD Pipeline Principles

Hono Idioms

Mobile Testing

Questions about Ruby Idioms

Install Ruby Idioms

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Ruby Idioms and Patterns

Modern Ruby Features (3.x)

Error Handling

Naming

Testing

Formatting and Static Analysis

Related

Files

Compare with similar skills

Similar skills

More from irahardianto/awesome-agv

Related

Questions about Ruby Idioms