History

Tianyi Cui d37b192aa9 Merge branch 'master' into fix/workspace-instruction-frame-metadata		2026-07-30 12:16:41 +08:00
..
skill	Merge latest master into codex/migrate-to-oxlint	2026-07-30 00:13:30 +08:00
skill-local	test(skill-local): cover root unlink rewatch	2026-07-30 12:02:21 +08:00
tool-skill	Merge remote-tracking branch 'origin/master' into codex/web-queue-actions	2026-07-30 03:33:41 +08:00
README.i18n.yaml	Merge origin/master at ecbf75a5e7 into skill catalog hot refresh	2026-07-29 21:42:18 +08:00
README.md	feat(skill): hot-refresh skill catalogs	2026-07-27 16:50:56 +08:00
README.zh.md	Merge origin/master at ecbf75a5e7 into skill catalog hot refresh	2026-07-29 21:42:18 +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/.