# Module LittleGhost::Agent::Skills

Documentation version: Edge

Canonical HTML: https://littleghostai.org/docs/LittleGhost/Agent/Skills.html

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.