Skip to content

smelt.skills

Tier: Host - Available in every runtime, including headless mode.

Visibility: Public - Stable Lua API intended for user config and plugins.

List and load skill content from the SkillLoader populated at startup. Markdown custom commands can opt into skill discovery with agent_skill: true (or agent-skill: true) in their frontmatter; the skill name is the command file stem. Loaded command skills are static context: slash-command arguments are not included, and shell output markers are not evaluated.

smelt.skills.content

fun(name: string): string?, string?

Load the skill named name and return (content, nil) on success or (nil, err_string) if the skill is missing or failed to load.

smelt.skills.info

fun(): table

Return every discovered skill as { name, description, source, location, shadowed } rows sorted by name.

smelt.skills.list

fun(): table

Return the names of every skill discovered by the loader as a Lua array. Empty when no skills are loaded.