Tianyi Cui
21d0c2e29c
The user-global instruction scope now reads two roots: $DSH_HOME/AGENTS.md first, then the shared agents root that other agent tools use ($DSH_AGENTS_HOME, else ~/.agents). Both resolve from the process environment through @deepseek-ai/dsh-home-paths; no config field is added, because the stack base (PR #5718) removed the per-row home override. The two files are candidates of one candidate group: identical trimmed content renders once from the harness home, an unobservable candidate preserves the group's last-good state, and reconciliation probes both roots so external edits, removals, and new files become visible change notices. A candidate dropped as a duplicate keeps being reconciled, so deleting or changing the retained candidate promotes it. The harness-home file keeps its recorded `user-global` scope key; the shared file carries `agents-global`. A user-global delta states `These user-global instructions apply to all work.` instead of naming its reconciliation scope, and a project path whose first component would collide with a user-global scope directory renders with a leading `.` so it keeps its own scope.
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 |
tool-workspace-dependencies/ |
Reports bundled Office interpreter paths and versions for Desktop and SDK carriers | 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 reference — the model and user invocation controls.
Dev Note
Working context for maintainers — click to expand
None.