Tianyi Cui
87f0df0550
Keep the master refresh separate from the V3-to-V4 lossless-conversion and checkpoint JSON fixes so the release baseline and each feature change remain independently reviewable. This checkpoint extends the already-published 4435f6f519 merge before the #4583 child is rebased. Integrate exactly master 5ec3ffe337062ab5bb4955933008afe8d0a0b915. Its #4156 changes add watched file/document refresh, filesystem watch readiness, directory expansion restoration, and chat bottom-follow fixes. They update shared filesystem and Client consumers without changing Session format or snapshot generation. The merge has no conflicts. Its 114-file scope and line counts match upstream; code and prose additions/removals are unchanged. Only the two translation pairing records incorporate the release branch's retained V4 documentation. Validation: 762 owner tests passed (1 platform skip), 11 focused Web tests passed, full build passed, and all 41 doc-sync checks passed. Runtime closure and Client package checks passed; fs-local publint completed with the existing source-wildcard export warning.
description, kind
| description | kind |
|---|---|
| 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. | 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, skill-badge for the optional official badge, and skill-office for Word, PowerPoint, and Excel workflows. 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 |
skill-office/ |
Bundles Word, PowerPoint, and Excel workflows with structural file checks | 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.
Dev Note
Working context for maintainers — click to expand
None.