module LittleGhost::Agent::Skills

Let an agent discover application-authored instructions only when it needs them. Skills are file-backed guides advertised in the system prompt and loaded through a model-callable catalog tool.

class CustomerSupportAgent < LittleGhost::Agent
  skills paths: [File.expand_path("../skills", __dir__)]
end

A run with a refunds skill sees that skill in its discovery prompt. The model can then call the skills tool to read the full guide before handling the refund request.

Including this module alone has no effect. The skills declaration installs the catalog tool and prompt callback; paths may be static or resolved for each run, and omitted paths use the runtime’s configured skill roots. An empty catalog exposes neither a tool nor discovery text.

Skill files influence model behavior and should come from application-owned, trusted roots. Catalog loading applies its own file, count, and size bounds.