Module: Omakase::Skills

Defined in:
lib/omakase/skills.rb

Overview

A skill is a directory with a SKILL.md: YAML front matter says what it is, the body is the guidance. The description is listed with the agent's other capabilities; the body only arrives when the model calls the method — which is all "loaded on demand" has to mean.

Class Method Summary collapse

Class Method Details

.attach(agent_class, path) ⇒ Object

Raises:



11
12
13
14
15
16
17
18
19
20
 
# File 'lib/omakase/skills.rb', line 11

def attach(agent_class, path)
  directory = File.expand_path(path)
  front_matter, body = parse(File.read(File.join(directory, "SKILL.md")))
  name = (front_matter["name"] || File.basename(directory)).tr("-", "_").to_sym
  raise Error, "#{agent_class} already has ##{name}" if Capabilities.names(agent_class).include?(name)

  agent_class.describe(front_matter["description"].to_s)
  agent_class.define_method(name) { "#{body}\n\nFiles for this skill are in #{directory}." }
  name
end

.parse(text) ⇒ Object

The front matter every SKILL.md in the wild is written with.



23
24
25
26
27
28
 
# File 'lib/omakase/skills.rb', line 23

def parse(text)
  match = text.match(/\A---\n(.*?)\n---\n(.*)\z/m)
  return [{}, text.strip] unless match

  [YAML.safe_load(match[1]), match[2].strip]
end