primus.skills package

Primus operational skill repository.

exception primus.skills.InvalidSkillKeyError

Bases: ValueError

Raised when a caller asks for an unsafe or unknown skill id.

class primus.skills.SkillRepository(root_dir: str)

Bases: object

Index repo-local operational skills rooted at skills/.

Only */SKILL.md files are indexed. The stable public id is derived from the containing folder name, so renaming frontmatter display names does not break console references.

__init__(root_dir: str) → None
get_skill(skill_id: str, *, mode: str | None = None) → Skill

Return the full body for one skill id.

list_skills(*, query: str | None = None, tags: Iterable[str] | None = None, mode: str | None = None) → SkillListResult

Return metadata summaries for matching skills.

property root: str

Submodules