README.md 2.3 KB
description: "The skill group map: reusable agent instructions discovered from providers and loaded through the session catalog and skill tool, for users and maintainers navigating the group."
kind: "package-group"
skill/ — skill capability family
English | 中文
Summary
The skill family lets agents and users discover and load reusable task instructions only when needed. Use skill/ to combine catalogs and expose one instruction set per name; choose skill-filesystem for project, custom, or user-directory discovery, and skill-badge for the optional official badge. Add tool-skill when models should receive a sorted, durable session catalog, load full instructions through the skill tool, or accept direct /name invocation. Different sources produce the same model-visible format, and model access requires at least one source.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
skill/ |
Registry that merges skill catalogs from any provider and resolves the winning skill for a name | ctx.skills |
skill-filesystem/ |
Discovers skills from project, custom, and user directories and watches them for changes | registers on ctx.skills |
skill-badge/ |
Bundles the official "powered by dsh" badge skill, disabled by default | registers on ctx.skills |
tool-skill/ |
Publishes the session skill catalog and the model-facing skill loader tool |
registers on ctx.tools |
Related documentation
Start with the subsystem reference for the shared vocabulary, then read the Agent Notes for the design rationale.
- Skill subsystem reference — the registry, provider contract, local discovery priority, and the catalog and tool.
- Skill invocation policy Agent Note — the model and user invocation controls.