skills_middleware

Return (skill_dir, subfolders) pairs found under source_path.

Walks the source tree, treating any directory that directly contains a SKILL.md as a skill directory (a recursion leaf, like a plugin walker). subfolders holds the directory names between the source root and the skill directory, excluding the skill directory's own name.

Async counterpart of discover_skill_dirs.

Load and namespace every skill found under a plugin source.

Reads each discovered skill directory's SKILL.md directly, since the SDK loader only scans one level below a source and would not read a leaf directory's own SKILL.md. Nested directories become :-joined namespace segments (e.g. plugin:foo:bar:review).

Async counterpart of load_namespaced_skills.

Load namespaced plugin skills without extending the SDK source API.

Wraps the SDK SkillsMiddleware. Sources without a namespace load exactly as the SDK loads them. Sources carrying a plugin namespace are walked recursively so nested skill directories (skills/foo/bar/review/SKILL.md) are discovered, and each skill's name is qualified as plugin_id:foo:bar:review before the last-one-wins merge — matching the plugin skill naming convention.