Skip to content

base

diapason.skills.sources.base

Source resolver ABC + ResolvedSkill dataclass.

ResolvedSkill dataclass

A skill found in an upstream source, ready to import.

Lightweight — does not include the full SKILL.md body. The importer reads the file from path when actually installing.

SourceResolver

Bases: ABC

Abstract base for a skill source resolver.

Implementations clone or pull an upstream repo into a cache directory, walk the cache to find SKILL.md files, and return ResolvedSkill objects that the importer can install.

cache_dir() abstractmethod

Where this source clones its repo.

filter_by_category(category)

Return skills whose category exactly matches category.

list_skills() abstractmethod

Walk the cache directory and return all discoverable skills.

resolve(query)

Filter list_skills() by name (substring match).

Empty query returns all skills.

sync() abstractmethod

Clone or pull the upstream repo into the cache.