History

imccyu 8cbdd5b9d0 refactor(session): route construction through Session.create		2026-08-05 11:56:14 +08:00
..
skill	Merge origin/master into xjt/proofreading-active-docs-2-apply	2026-08-05 10:57:53 +08:00
skill-local	Merge origin/master into xjt/proofreading-active-docs-2-apply	2026-08-05 10:57:53 +08:00
tool-skill	refactor(session): route construction through Session.create	2026-08-05 11:56:14 +08:00
README.i18n.yaml	docs(i18n): proofread active Chinese documentation	2026-08-04 17:36:14 +08:00
README.md	feat(skill): hot-refresh skill catalogs	2026-07-27 16:50:56 +08:00
README.zh.md	docs(i18n): proofread active Chinese documentation	2026-08-04 17:36:14 +08:00

README.md

skill/ - skill capability family

English | 中文

The canonical three-package capability seam for reusable agent instructions: a provider registry, a local implementation, and the model-facing catalog/loader consumer. All are product packages.

Package	Role	ctx key
`skill/`	Provider registry, precedence resolution, complete/incomplete catalog snapshots, and full-definition lookup	`ctx.skills`
`skill-local/`	Project/custom/user filesystem provider with membership watching	(registers on `ctx.skills`)
`tool-skill/`	Initial and replacement catalogs plus the model-facing `skill` loader	(registers on `ctx.tools`)

The interface lives at skill/skill/. Providers register synchronously and perform asynchronous discovery through ctx.skills; tool-skill consumes only that interface, so an embedded or remote provider can replace or complement skill-local without changing the model-facing contract. agent-core loads this family by default, but it remains a capability outside the core control spine, parallel to bash/, fs/, web/, and subagent/.