Class: Rubino::Skills::Skill

Inherits:
Object
  • Object
show all
Defined in:
lib/rubino/skills/skill.rb

Overview

Represents a single skill. Two layouts are supported:

* flat file  — <dir>/<name>.md (the skill name is the basename)
* directory  — <dir>/<name>/SKILL.md (the skill name is the dir name,
  plus bundled files under references/ scripts/ assets/ etc.)

In both cases ‘path` points at the markdown body that carries the name/description frontmatter. Directory skills also expose `linked_files` (relative paths of bundled files) and can read a specific bundled file sandboxed to the skill’s own directory.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(path:) ⇒ Skill

Returns a new instance of Skill.



19
20
21
22
23
24
25
26
27
 
# File 'lib/rubino/skills/skill.rb', line 19

def initialize(path:)
  @path = path
  @metadata = {}
  @content = nil
  @linked_files = []
  @directory = directory_skill? ? File.dirname(path) : nil
  discover_linked_files! if directory?
  parse_frontmatter!
end

Instance Attribute Details

#description ⇒ Object (readonly)

Returns the value of attribute description.



17
18
19
 
# File 'lib/rubino/skills/skill.rb', line 17

def description
  @description
end

#linked_files ⇒ Object (readonly)

Returns the value of attribute linked_files.



17
18
19
 
# File 'lib/rubino/skills/skill.rb', line 17

def linked_files
  @linked_files
end

#metadata ⇒ Object (readonly)

Returns the value of attribute metadata.



17
18
19
 
# File 'lib/rubino/skills/skill.rb', line 17

def metadata
  @metadata
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



17
18
19
 
# File 'lib/rubino/skills/skill.rb', line 17

def name
  @name
end

#path ⇒ Object (readonly)

Returns the value of attribute path.



17
18
19
 
# File 'lib/rubino/skills/skill.rb', line 17

def path
  @path
end

Instance Method Details

#content ⇒ Object

Returns the full skill content (loaded lazily)



40
41
42
 
# File 'lib/rubino/skills/skill.rb', line 40

def content
  @content ||= load_content
end

#current_linked_files ⇒ Object

Live relative paths of bundled files, recomputed from disk. Unlike the linked_files snapshot taken at init, this reflects the current dir state — so an error message built from it can’t list a file that #read_file just failed to find (the W3 self-contradiction). Empty for flat-file skills.



74
75
76
77
78
 
# File 'lib/rubino/skills/skill.rb', line 74

def current_linked_files
  return [] unless directory?

  collect_linked_files
end

#dir ⇒ Object

The skill’s own directory (only for directory skills).



35
36
37
 
# File 'lib/rubino/skills/skill.rb', line 35

def dir
  @directory
end

#directory? ⇒ Boolean

True when this skill is backed by a <name>/SKILL.md directory.

Returns:

  • (Boolean) 


30
31
32
 
# File 'lib/rubino/skills/skill.rb', line 30

def directory?
  !@directory.nil?
end

#loaded? ⇒ Boolean

Returns true if the skill has been fully loaded

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/rubino/skills/skill.rb', line 45

def loaded?
  !@content.nil?
end

#read_file(relative_path) ⇒ Object

Reads a bundled file by its relative path, sandboxed to the skill dir. Returns the file contents, or nil if the skill has no directory, the path escapes the skill dir, or the file does not exist.

Resolve and read happen back-to-back with no listing step in between, so the caller can’t observe a “present in the listing but unreadable” state from THIS method. A File::ENOENT between #file? and #read (the skill dir being torn down mid-call) is swallowed to nil rather than raised, so a concurrent teardown reads as a clean miss instead of a crash (W3).



58
59
60
61
62
63
64
65
66
67
 
# File 'lib/rubino/skills/skill.rb', line 58

def read_file(relative_path)
  return nil unless directory?

  resolved = resolve_within_dir(relative_path)
  return nil unless resolved && File.file?(resolved)

  File.read(resolved)
rescue Errno::ENOENT, Errno::EACCES
  nil
end

#summary ⇒ Object

Returns a summary for the agent to see available skills



81
82
83
 
# File 'lib/rubino/skills/skill.rb', line 81

def summary
  "#{@name}: #{@description}"
end