`yggdrasil.loki.guides`¶

guides ¶

The guide skill — point work at the most optimized yggdrasil path.

Loki knows the project it lives in. This is its do-it-the-yggdrasil-way adviser: a curated map of recipes that, for a given task, names the right abstraction to reach for (the io handlers, HTTPSession, Arrow, Field / DataType casting, execution plans, the Databricks dbc accessors, Tabular.display …), shows the short idiomatic snippet, and calls out the hand-rolled anti-pattern to avoid.

Data over code: the knowledge is the :data:GUIDES list; the skill just matches a task to the relevant guides and (optionally) has the agent's engine synthesize a concrete, grounded plan from them.

Guide `dataclass` ¶

Guide(
    id: str,
    title: str,
    signals: tuple[str, ...],
    summary: str,
    use: tuple[str, ...],
    example: str,
    avoid: tuple[str, ...],
)

One yggdrasil recipe: when it applies, what to use, and what to avoid.

as_text ¶

as_text() -> str

A compact, model/human-readable rendering of the guide.

GuideSkill ¶

Bases: LokiSkill

Guide a task to the most optimized yggdrasil implementation.

Matches the task to the relevant recipes in :data:GUIDES — the right abstraction, the idiomatic snippet, the anti-pattern to avoid — and, when plan=True and an engine is reachable, has the agent synthesize a concrete plan grounded only in those yggdrasil features. Runs anywhere.

available ¶

available(agent: 'Loki') -> bool

True when this skill can run in agent's environment.

Default: available everywhere, unless :attr:requires names a backend that isn't detected. Override for finer checks.

match ¶

match(task: str, *, top: int = 3) -> list[Guide]

The guides most relevant to task, best first (by signal hits).

yggdrasil.loki.guides¶