Validate and import agent skills into versioned server storage

Adds a SKILL.md bundle validator, immutable per-skill versions with
content digests and deduplication, protocol requests to import, list and
show skills, and the pipelines skills import/list/show commands. Imports
are serialised so concurrent imports never share a version number.
This commit is contained in:
2026-11-12 11:15:28 +00:00
parent 24618964ce
commit bd4f1437bc
13 changed files with 811 additions and 0 deletions
+14
View File
@@ -0,0 +1,14 @@
# Skills
`pipelines skills import FOLDER` validates a skill locally and, after confirmation,
sends its bytes to the server. A bundle contains one root `SKILL.md` with YAML
frontmatter (`name` and `description`) and may contain only `references/`,
`scripts/`, and `assets/`. Symlinks, traversal paths, nested `SKILL.md` files,
executables outside `scripts/`, and oversized bundles are rejected. Files are
fingerprinted in sorted path order with SHA-256; importing the same digest is
idempotent. The server keeps immutable versions in SQLite metadata and stores
their files below its data directory. Skills are metadata-only at this stage:
they are not executed or injected into stages or chats.
Use `pipelines skills list` and `pipelines skills show NAME [--version N]` to
inspect imported versions.