jeevesagent.skills.source

SkillSource — a directory of skills with an optional label.

A user-facing input. Wraps a path to a skills folder; we scan it recursively at construction time, building one Skill per discovered SKILL.md file.

The optional label shows up in the catalog the agent sees, e.g. "  - my-skill [Project]: ...". Useful when multiple sources are mounted and you want to see at a glance which one a skill came from.

Classes

SkillSource

A folder of skills + an optional label.

Module Contents

class jeevesagent.skills.source.SkillSource

A folder of skills + an optional label.

classmethod coerce(item: SkillSource | str | pathlib.Path | tuple[str | pathlib.Path, str]) → SkillSource

Normalize one user-supplied source spec.

Accepts: * SkillSource(...) — used as-is * str / Path — bare path, no label * (path, label) — path with explicit label

discover() → list[jeevesagent.skills.skill.Skill]

Find every SKILL.md under this source directory.

Recurses one level (most common layout: skills/<name>/SKILL.md) but also handles deeper nesting. Each SKILL.md becomes one Skill instance with this source’s label attached.

label: str | None = None

path: pathlib.Path