onboard-skills
Discovers and installs agent skills into a project (or the user-global lane) with the qvr CLI, where qvr.toml declares intent and qvr.lock is the resolved source of truth for what loads. Use when a user wants to find, add, register, or install skills from a skills registry or GitHub repo with qvr — e.g. "register a skill registry", "search for a qvr skill", "qvr add this skill", "install a skill globally", or "why is my skill not loading after I dropped it into the agent's skills directory". Covers registry add, search, the one-step add github.com/org/repo/skill form, --global, and sync.
quiver-playground · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add try-agora/qvr --skill onboard-skills技能说明
name: onboard-skills description: > Discovers and installs agent skills into a project (or the user-global lane) with the qvr CLI, where qvr.toml declares intent and qvr.lock is the resolved source of truth for what loads. Use when a user wants to find, add, register, or install skills from a skills registry or GitHub repo with qvr — e.g. "register a skill registry", "search for a qvr skill", "qvr add this skill", "install a skill globally", or "why is my skill not loading after I dropped it into the agent's skills directory". Covers registry add, search, the one-step add github.com/org/repo/skill form, --global, and sync. metadata: author: quiver-playground version: "1.0.0"
Onboard skills with qvr
qvr installs agent skills (SKILL.md bundles) into a project from one or
more Git registries. qvr is agent-agnostic — it installs into whichever agent
target directories you configure (e.g. .claude/skills/, .agents/skills/, …).
A project's skill set lives in two committed files: qvr.toml is the
hand-editable intent (which skills, which default agents), and qvr.lock
(TOML, schema v5) is the resolved proof and the source of truth for what an
agent actually loads — anything that lands in a managed agent directory without a
matching lock entry is hidden on the next sync. Mutating commands write through to
both files. This skill walks discovery → install → reconcile.
When to use this
- The user wants to find a skill, add a registry, or install a skill with
qvr. - A skill was copied into a managed agent directory by hand and "isn't showing up".
- The user wants a skill available in every session (ambient/global), not just one project.
Do not use this for editing/forking a skill (see fork-and-publish-skill),
or for reproducing an existing set on another machine (see reproduce-skill-env).
Prerequisites
-
Confirm the CLI is present and note the version:
qvr --version -
Run from the project root where you want
qvr.toml+qvr.lockto live. The files and the agent-target symlinks are written relative to the current directory.
Workflow
1. Discover what's available
Search already-registered registries (substring match on name/description, with
optional hard filters). At least one of a query, --tag, or --author is
required:
qvr search pdf
qvr search --tag testing --author acme
qvr search review --full # untruncated descriptions
qvr search forms --github # search GitHub for repos tagged agent-skills
List registries and the skills each one indexes:
qvr registry list
qvr registry list anthropics/skills --full
2. Install a skill
One-step install (no prior registry add needed). Point at a skill inside a repo; qvr auto-registers the source, then installs:
qvr add github.com/org/repo/tdd # register org/repo, install tdd
qvr add github.com/org/repo/tdd@v2 # pin a branch or tag
qvr add github.com/org/repo # single-skill repo: install the lone skill
By name, once the source is registered:
qvr registry add https://github.com/acme-labs/agent-skills
qvr add tdd
qvr add tdd lint review # batch — each must resolve to a registered skill
qvr add tdd@v2 # @<ref> pins a branch, tag, or commit
Useful flags on add:
--registry <org>/<repo>— scope resolution to one registry when the same skill name exists in several. Use the full<org>/<repo>name, not a short alias.--target <agent>[,<agent>…]— install into specific agent target dirs (e.g.--target claude,cursor). When omitted, targets resolve in order:--targetflag > the project'sqvr.toml[project].default-targets(set once viaqvr target add claude cursor) > the machine-localdefault_targetconfig. Runqvr target listto see every supported agent and the project's current defaults.--as <localname>— install under a different local name so two versions of the same skill can coexist (single skill only).--force— allow replacing an existing lock entry pinned at a different ref.--no-scan— skip the install-time security scan (seeverify-skill-supply-chainbefore reaching for this).
3. Install into the global (ambient) lane
A globally installed skill appears in every session via ~/.<agent>/skills/,
backed by ~/.quiver/qvr.lock:
qvr add --global diagnose
qvr list --global
4. Reconcile on-disk state to the lock
qvr sync makes the managed agent target dirs match the lock:
missing worktrees are restored, and managed symlinks not in the lock are
removed — this is the "hidden by default" guarantee that makes the lockfile
authoritative.
qvr sync # reconcile project
qvr sync --global # reconcile the global lane
qvr sync --dry-run # show what would change, touch nothing
A symlink whose target points outside qvr's managed cache (e.g. into your own dev dir) is left alone and surfaced in the output rather than deleted.
5. Confirm the result
qvr list # installed skills from the lock
qvr tree # grouped by registry / target
qvr info tdd # metadata, provenance, file tree (local-only, fast)
Gotchas
- The lockfile wins. Dropping a folder into a managed agent directory does nothing
durable — it's removed on the next
qvr syncunless there's a lock entry. Install viaqvr add(orqvr add --local <path>for an immutable copy of a local folder) instead. - Registry names are nested
<org>/<repo>. The bare clone lives at~/.quiver/registries/<org>/<repo>.git/.--registry,registry update, andregistry removeall expect that full name. Override the inferred name withqvr registry add <url> --name <alias>only when two repos collide. - Web tree/blob URLs are rejected. Pass the repo URL, not a