Skip to content

Index

diapason.skills.sources

Skill source resolvers — Hermes, OpenClaw, generic GitHub.

GitHubResolver

Bases: SourceResolver

Generic resolver for any GitHub repo containing SKILL.md files.

HermesResolver

Bases: SourceResolver

Resolves skills from the Hermes Agent repository.

list_skills()

Walk skills///SKILL.md.

sync()

Clone or pull the Hermes repo into the cache directory.

OpenClawResolver

Bases: SourceResolver

Resolves skills from the OpenClaw skill index.

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.