Module: Nexo::Skills

Defined in:
lib/nexo/skills.rb

Overview

Composes the ruby_llm-skills gem so a developer can drop a SKILL.md package into app/skills/<name>/ and attach it to an agent with a single skills class macro — no loader wiring.

ruby_llm-skills is a SOFT (optional) runtime dependency: it is required lazily by load! the first time a skill is used. With the gem absent, require "nexo" still loads cleanly; only touching a skill raises MissingDependencyError with install guidance.

A loaded skill contributes its instructions (the SKILL.md body) to a chat. It ships no independent tools — its scripts/ and references/ files are reached by the model through Nexo's own sandbox-backed, permission-gated tools, so attaching a skill never widens the agent's effective capabilities. See the spec's "Verified APIs" / safety resolution for why the gem's progressive disclosure SkillTool (which does ungated File.read) is deliberately not attached.

Class Method Summary collapse

Class Method Details

.find(name) ⇒ RubyLLM::Skills::Skill

Resolves a skill name (symbol or string) to a loaded skill object read from the filesystem under Nexo.config.skills_path. The filesystem is the only skill source in v1 — zip/DB/remote loading is deferred entirely to ruby_llm-skills.

Calls load! first (so an absent gem surfaces MissingDependencyError), then resolves <skills_path>/<name>/SKILL.md. A missing file raises Error whose message names the resolved path.

Returns:

  • (RubyLLM::Skills::Skill) —

    the loaded skill (exposes #content, #name, #description).

Raises:



43
44
45
46
47
48
49
50
51
 
# File 'lib/nexo/skills.rb', line 43

def find(name)
  load!

  dir = File.join(Nexo.config.skills_path.to_s, name.to_s)
  skill_md = File.join(dir, "SKILL.md")
  raise Error, "skill not found: #{skill_md}" unless File.exist?(skill_md)

  RubyLLM::Skills.load(dir)
end

.load! ⇒ Object

Lazily loads the ruby_llm-skills gem. Idempotent (a second call is a cheap no-op once the gem is loaded). Raises MissingDependencyError — naming the gem and the exact remedy — when the gem is not installed.



25
26
27
28
29
30
 
# File 'lib/nexo/skills.rb', line 25

def load!
  require "ruby_llm/skills"
rescue LoadError
  raise MissingDependencyError,
    'Skills require the `ruby_llm-skills` gem. Add `gem "ruby_llm-skills"` to your Gemfile.'
end