chore(skills): wire agent/skills to the skills CLI global store
Retroactive provenance registration: the 10 pi-era skill snapshots are byte-identical to upstream (38 skills mattpocock/skills + find-skills vercel-labs/skills), now canonically installed at ~/.agents/skills with store lockfile ~/.agents/.skill-lock.json (39 entries, folder hashes). omp is not a skills-CLI agent id, so the omp tier becomes manual wiring: replace the 10 tracked skill directories with symlinks into the store and link the remaining 29 upstream skills the same way (39 links). The repo now records the enabled set, never content; skills update -g propagates through the links. managed-skills tier untouched. Docs: skill-store-wiring.md (+index). Snapshot of the old real dirs at /tmp/agent-skills-snap-20261018 for the transition window.
This commit is contained in:
1 parent
57e255f930
commit
7d9486f646
67 files changed
+84
-1168
No files matched your search
@@ -14,5 +14,6 @@ Complete list of 68+ supported coding agents, their --agent flags, and installat
|
||||
| [related-links.md](related-links.md) | reference | Links to the Agent Skills specification, skills directory, integration guide,... |
|
||||
| [skill-discovery.md](skill-discovery.md) | reference | How the skills CLI discovers SKILL.md files in repositories — flat layout, ca... |
|
||||
| [skill-format.md](skill-format.md) | reference | The required frontmatter fields, optional fields, internal skills, and struct... |
|
||||
| [skill-store-wiring.md](skill-store-wiring.md) | reference | How omp's agent/skills directory is symlinked into the skills CLI global store, and where lockfile provenance lives. |
|
||||
| [source-formats.md](source-formats.md) | reference | All accepted source formats for skills add and use — GitHub shorthand, full U... |
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
type: reference
|
||||
title: omp Skill Store Wiring
|
||||
description: How omp's agent/skills directory is symlinked into the skills CLI global store, and where lockfile provenance lives.
|
||||
tags:
|
||||
- skills
|
||||
- symlinks
|
||||
- provisioning
|
||||
timestamp: 2026-10-18
|
||||
verified: 2026-10-18
|
||||
---
|
||||
|
||||
# omp Skill Store Wiring
|
||||
|
||||
omp is NOT a registered agent in the `skills` CLI (79-agent registry checked in
|
||||
`dist/cli.mjs` 2026-10-18; see [Agent Support](/tools/vercel-labs-skills/agent-support.md)),
|
||||
so `skills add` never writes to `~/.omp/agent/skills/` on its own. The wiring is
|
||||
manual, retrofitted 2026-10-18:
|
||||
|
||||
- **Canonical store:** `~/.agents/skills/<name>/` — real files, written by
|
||||
`npx skills add <owner>/<repo> --all -g` (universal agent, global scope).
|
||||
- **Provenance:** `~/.agents/.skill-lock.json` (store lockfile, version 3): per
|
||||
skill `source` (e.g. `mattpocock/skills`, `vercel-labs/skills`), `skillPath`,
|
||||
`skillFolderHash`, timestamps. 39 entries as of 2026-10-18: 38 from
|
||||
`mattpocock/skills`, `find-skills` from `vercel-labs/skills`.
|
||||
- **omp tier:** every entry in `agent/skills/` (this repo) is a **symlink** to
|
||||
`~/.agents/skills/<name>` — 39 links. `manage_skill` writes real dirs into the
|
||||
separate tier `agent/managed-skills/`; that tier is untouched by this scheme.
|
||||
|
||||
## Consequences
|
||||
|
||||
- `skills update -g` refreshes every skill for omp through the links; the repo
|
||||
records only the link set (which skills are enabled), never content.
|
||||
- A fresh workstation needs two steps: `npx skills add mattpocock/skills --all -g`
|
||||
(+ `find-skills` from `vercel-labs/skills`), then re-create the symlinks;
|
||||
`git pull` alone yields dangling links until the store exists.
|
||||
- `skills ls` from a repo whose layout contains `agent/skills` mislabels those
|
||||
links as Eve project skills (path collision with Eve's `agent/skills` dir);
|
||||
harmless attribution noise.
|
||||
|
||||
## Related
|
||||
|
||||
* [Lock File](/tools/vercel-labs-skills/lock-file.md) — lockfile format and update checking
|
||||
* [Installation Scope](/tools/vercel-labs-skills/installation-scope.md) — symlink vs `--copy` methods
|
||||
Reference in new issue
Block a user