Skills¶

Skill 是一个包含 SKILL.md 的本地能力包。它主要向模型提供说明和资源位置，不等同于 Python 工具。

接口	用途
`SkillsManager`	安装、加载、删除和选择 Skills
`Skill`	一个已加载 Skill 的信息
`SkillLoadResult`	Skills 和非致命加载错误
`SkillError`	单个 Skill 的加载错误

skill_names=None 表示向模型提供全部已加载 Skill 的摘要，skill_names=[] 表示不提供任何 Skill。

公开接口¶

Local skill discovery and prompt rendering.

Skill `dataclass` ¶

Model-visible summary for a local skill package.

SkillError `dataclass` ¶

Non-fatal error found while loading one skill file.

SkillLoadResult `dataclass` ¶

Loaded skills plus non-fatal parse/load errors.

SkillsManager ¶

Load user-installed skills and render their prompt context.

install_skills ¶

install_skills(sources: Sequence[str | Path], *, replace: bool = False) -> SkillLoadResult

Install skill package directories and reload the catalog.

Every source must be a directory containing SKILL.md. Packages are copied and validated in a temporary staging directory before any installed skill is changed.

remove_skill ¶

remove_skill(name: str) -> SkillLoadResult

Remove an installed skill by its declared name and reload.

build_skills_summary ¶

build_skills_summary(skill_names: list[str] | None = None) -> str

Render skills for prompt context.

skill_names=None renders all skills, [] renders none, and a non-empty list renders only the named skills in the given order.

render_skills_summary ¶

render_skills_summary(skills: list[Skill]) -> str

Render a system-prompt XML summary of available skills.