ruby-gem-skills

name	ruby-gem-skills
description	Locate and load gem-skill's cached, version-specific SKILL.md for a Ruby gem. Use whenever working with, debugging, or writing Ruby code that uses a third-party gem (Bundler/Gemfile projects or installed gems) to get accurate, version-pinned API knowledge before relying on memory.

ruby-gem-skills

Detailed, version-specific knowledge for installed Ruby gems is generated by the gem-skill tool and cached on this machine at:

~/.gem/skills/<gem_name>/<version>/SKILL.md

(Use $GEMSKILL_DIR instead of ~/.gem/skills if that variable is set.)

Most assistants do not scan that directory by default, so follow this procedure to find and load a gem's skill before answering from memory.

When to use

• Writing or debugging Ruby code that calls a third-party gem's API.
• Verifying exact method signatures, options, defaults, or behavior for a specific gem version.

How to load a gem's skill

1. Determine the gem version in use:
   • In a project with a Gemfile.lock, read the locked version for the gem.
   • Otherwise run gem list <gem_name> (or bundle show <gem_name>) to find the installed version.
2. Read the cached skill for that exact version:

   ~/.gem/skills/<gem_name>/<version>/SKILL.md
   

3. If it exists, treat its contents as the authoritative, version-pinned reference for that gem and prefer it over training memory. Skills are version-specific — always match the version actually in use.

If the skill is missing

Tell the user how to generate it:

• One gem: gem skill install <gem_name>
• Every gem in a project (from the project root): bundle skill install
• Verify an existing skill against the gem's real source: gem skill verify <gem_name>

Notes

• A metadata.json sits beside each SKILL.md with provenance (model, sources, and verification status). It is for tooling and humans, not required reading.
• A green checkmark next to a version in gem skill list means that skill was verified against the gem's actual source code.