Struct SkillRegistry 

pub struct SkillRegistry { /* private fields */ }

Registry of loaded skills, indexed by name.

Implementations

impl SkillRegistry

pub fn new() -> Self

pub fn reload(&mut self, working_dir: &Path) -> Vec<String>

Reload skills from all sources.

Load order (later entries overwrite earlier ones — higher priority wins):

Global (home dir or ATOMCODE_HOME):

1. {home}/.claude/commands/*.md legacy flat, Claude Code compat
2. {home}/.atomcode/commands/*.md legacy flat, atomcode native
3. {home}/.claude/skills/*/SKILL.md directory-style, Claude Code compat
4. {home}/.atomcode/skills/*/SKILL.md directory-style, atomcode native

Project (working dir): 5. .claude/commands/*.md 6. .atomcode/commands/*.md 7. .claude/skills/*/SKILL.md 8. .atomcode/skills/*/SKILL.md

Same-name skill from a skills/ directory beats one from commands/ at the same level because it is loaded after.

Note: If ATOMCODE_HOME env var is set, it overrides the default home directory for atomcode-specific paths (.atomcode/commands and .atomcode/skills). Claude Code compat paths (.claude/*) always use the system home directory. Reload skills. Returns a list of “skipped” diagnostics (one per rejected skill on disk). Callers in interactive contexts (TUI) can surface these gated behind verbose mode; non-interactive callers (agent bootstrap, /cd) drop them.

pub fn register(&mut self, skill: Skill)

Register a pre-built skill directly (used by plugin system).

pub fn get(&self, name: &str) -> Option<&Skill>

Look up a skill by name. Falls back to a unique *:name suffix match when the exact name misses AND the request is unqualified — covers the case where a hook-injected workflow plan or other external material refers to a plugin skill by its bare name (ascend-model-verification) instead of the registered fully qualified key (ascend-model-agent-plugin:ascend-model-verification).

Discipline: returns None when more than one namespace would match the bare name. Silent-pick-the-first would mask real ambiguity (and the LLM would invoke the wrong plugin) — better to error out so the caller surfaces the candidates.

pub fn is_empty(&self) -> bool

pub fn all(&self) -> impl Iterator<Item = &Skill>

All skills, regardless of invocation flags.

pub fn user_invocable(&self) -> impl Iterator<Item = &Skill>

Skills visible in the / menu (user-invocable).

pub fn invocable_by_llm(&self) -> impl Iterator<Item = &Skill>

Skills that Claude may invoke automatically.