// Catalog of all repo qv-* custom skills with one-line purpose and when-to-use. Use when the user asks what skills exist, which skill to use, how to invoke a skill, or invokes /qv-skill-list.
Generate changelogs for SDK pod packages using tag-based GitFlow. Use when preparing a release, generating changelog, or creating CHANGELOG_LLM.md.
Plan and run local PR validation for tetherto/qvac PRs. Reuses the shared PR worktree, discovers touched packages and package.json scripts, recommends a test tier, and analyzes results. Use when testing a PR or invoking /qv-pr-test.
Plans and scaffolds e2e tests in packages/sdk/e2e for a new or changed public SDK API. Use when adding or modifying SDK functionality that is exposed to consumers. Enforces happy / sad / error coverage, deterministic model-output assertions, mobile/desktop placement, smoke-suite selection, and local validation with run:local.
Release a package to NPM. Validates version bump, changelog, creates release branch, monitors CI, verifies publish.
Diagnose why CI checks are not running on a PR and/or why a PR cannot be merged, by cross-referencing the live PR state (via gh CLI) against the repo's labels, teams, CODEOWNERS, label-gate trust model, and tier-based approval rules. Read-only by default — proposes labels / re-review comments / unblock actions in plan-then-apply mode. Use when a developer asks "why aren't my checks running", "why can't I merge", "what's blocking my PR", or invokes /qv-devops-why-my-pr-not with a PR URL.
Generate changelog entries for a target add-on package. Use when preparing a new release.
| name | qv-skill-list |
| description | Catalog of all repo qv-* custom skills with one-line purpose and when-to-use. Use when the user asks what skills exist, which skill to use, how to invoke a skill, or invokes /qv-skill-list. |
All custom repo skills live under .cursor/skills/ and use the qv- prefix. Invoke with /qv-<name> in chat.
Not listed here (by design):
setup — repo-wide bootstrap (/setup); copies shared config from packages/ocr-onnx/.agent/ into .claude/ and .cursor/.packages/ocr-onnx/.agent/skills/ — framework skills (orchestrate, release, ci-validate, commit-trace, review); installed by /setup, not qv-* prefixed.| Mode | Behavior |
|---|---|
| Auto-invokable | No disable-model-invocation in frontmatter — the agent may load the skill when your request matches the description. |
| Manual only | disable-model-invocation: true — invoke explicitly with /qv-<name> (or ask the agent to run that skill). |
When unsure which skill fits, scan the tables below or ask: "which qv skill should I use for …?"
| Skill | Purpose | Use when |
|---|---|---|
qv-pr-review | Deep PR review: gitflow, CI, format, code quality, security; posts a PENDING GitHub review with inline comments. | Reviewing any PR, given a PR URL, or follow-up from a pod status/my skill. Manual: /qv-pr-review |
qv-pr-test | Plan and run local PR validation; discovers packages/scripts, recommends test tier, analyzes results. | Testing a PR locally before merge. Manual: /qv-pr-test |
qv-pr-mine | Your open PRs across all pods, merge readiness, Slack ping messages for reviewers. | "What are my PRs?", merge readiness, who to ping. Manual: /qv-pr-mine |
| Skill | Purpose | Use when |
|---|---|---|
qv-devops-pr-create | PR titles and bodies for CI/CD, composite actions, automation, IaC. | Creating a DevOps PR. Manual: /qv-devops-pr-create |
qv-devops-pr-review | /qv-pr-review plus GitHub Actions security audit (pinning, permissions, OIDC, secrets). | Reviewing PRs that touch DevOps paths. Manual: /qv-devops-pr-review |
qv-devops-pr-status | Team DevOps PR dashboard: re-review, stale, needs-review, conflicts. | DevOps pod PR queue health. Manual: /qv-devops-pr-status |
qv-devops-why-my-pr-not | Diagnose missing CI checks or merge blockers (labels, CODEOWNERS, approvals). | "Why aren't checks running?" / "Why can't I merge?" Manual: /qv-devops-why-my-pr-not |
qv-devops-daily-update | Slack standup (Done / Planned / Blockers) from PRs, reviews, CI. | DevOps EOD or standup. Manual: /qv-devops-daily-update |
| Skill | Purpose | Use when |
|---|---|---|
qv-sdk-pr-create | PR descriptions for SDK pod packages (sdk, cli, rag, logging, error). | Creating an SDK pod PR; may chain to backmerge. Auto |
qv-sdk-pr-status | Team SDK pod PR dashboard. | SDK pod PR queue. Manual: /qv-sdk-pr-status |
qv-sdk-changelog | Changelogs for SDK pod packages (tag-based GitFlow). | Release prep, CHANGELOG_LLM.md. Auto |
qv-sdk-backmerge | Open backmerge PR (release version bump + changelog → main). | After SDK release PR; often chained from qv-sdk-pr-create. Auto |
qv-sdk-e2e-create | Scaffold e2e tests in packages/sdk/e2e for new/changed public APIs. | Adding consumer-facing SDK APIs. Auto |
| Skill | Purpose | Use when |
|---|---|---|
qv-addon-changelog | Changelog entries for a target add-on package. | Add-on release prep. Auto |
qv-addon-pr-create | PR descriptions for non-SDK inference addons, decoder, OCR. | "Prepare PR description" for an addon. Auto |
qv-addon-release-notes | Release notes for addon packages. | Addon release notes. Auto |
| Skill | Purpose | Use when |
|---|---|---|
qv-registry-autobase-patterns | Autobase, HyperDB, multi-writer patterns, replication debugging. | Registry server, Autobase/HyperDB schemas, Corestore issues. Auto |
| Skill | Purpose | Use when |
|---|---|---|
qv-dev-diary-setup | Opt-in local dev diary (~/.config/qvac-pr-skills/). | Enable diary, diary --init, configure capture. Manual: /qv-dev-diary-setup |
qv-dev-diary | Read, inspect, append diary entries. | View today's log, add notes after setup. Manual: /qv-dev-diary |
qv-daily-work-update | Personal EOD update from diary + GitHub + PR state (+ optional Asana). | Personal standup / "what did I do today". Manual: /qv-daily-work-update |
qv-asana-sync | Look up and update Asana tasks (status, comments, PR links). | Sync Asana task, move status, validate config. Manual: /qv-asana-sync |
| Skill | Purpose | Use when |
|---|---|---|
qv-holepunch-dev | Holepunch/P2P/Bare/Pear API discovery via docs.pears.com and gh. | Hypercore, Hyperswarm, Autobase, Bare, Pear development. Auto |
qv-notice-generate | NOTICE files and third-party attributions for monorepo packages. | License compliance, release NOTICE updates. Auto |
| You want to… | Skill |
|---|---|
| Review any PR | qv-pr-review |
| Review a DevOps/CI PR | qv-devops-pr-review |
| Test a PR locally | qv-pr-test |
| See your open PRs | qv-pr-mine |
| SDK team PR board | qv-sdk-pr-status |
| DevOps team PR board | qv-devops-pr-status |
| Why CI/merge is blocked | qv-devops-why-my-pr-not |
| Write SDK PR body | qv-sdk-pr-create |
| Write addon PR body | qv-addon-pr-create |
| SDK release changelog | qv-sdk-changelog |
| Addon release changelog | qv-addon-changelog |
| Backmerge after SDK release | qv-sdk-backmerge |
| New SDK e2e tests | qv-sdk-e2e-create |
| Registry Autobase/HyperDB help | qv-registry-autobase-patterns |
| Holepunch stack help | qv-holepunch-dev |
| Generate NOTICE files | qv-notice-generate |
| List all skills | qv-skill-list (this file) |