Ruby Llm Skills

RubyLLM::Skills

Agent Skills for [RubyLLM](https://github.com/crmne/ruby_llm). Teach your AI how to do things your way.

[](https://badge.fury.io/rb/ruby_llm-skills) [](https://github.com/kieranklaassen/ruby_llm-skills/actions) [](https://github.com/EveryInc/compound-engineering-plugin)

Installation

gem "ruby_llm-skills"

Quick Start

chat = RubyLLM.chat
chat.with_skills
chat.ask "Create a PDF report from this data"

The LLM discovers skills, calls the skill tool, and gets instructions.

Usage

chat.with_skills                              # app/skills (default)
chat.with_skills("lib/skills")                # custom path
chat.with_skills("app/skills", "app/commands") # multiple paths
chat.with_skills("app/skills", user.skills)   # with database records

With RubyLLM::Agent (v1.12+)

class SupportAgent < RubyLLM::Agent
  model "gpt-5-nano"
  instructions "You are a support assistant."
  skills "app/skills", only: [:faq, :troubleshooting]
end

chat = SupportAgent.chat
chat.ask("How do I reset my password?")

agent = SupportAgent.new
agent.with_skills("extra/skills")
agent.ask("What can you help with?")

`agent.with_skills(...)` replaces the current skill tool configuration. To combine sources, pass all sources in a single `skills`/`with_skills` call.

Creating Skills

app/skills/
└── pdf-report/
    ├── SKILL.md
    ├── scripts/
    └── references/

SKILL.md requires frontmatter:

---
name: pdf-report
description: Generate PDF reports. Use when asked to create reports or export to PDF.
---

# PDF Report Generator

Instructions here...

Slash Commands

Single-file skills work as commands:

app/commands/
├── write-poem.md
└── review-code.md