verify-skills · v1.0.1 · 2026-10-15 · sha256 5c909518bde262a7

verify-skills v1.0.1A

Immutable. This exact content never changes and is served at /api/v1/blob/5c909518bde262a7.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_4x4b56r3rso6wshj/5c909518bde262a775764b9a67d5c575fc4c5183b48b655b2c3d2a84503b6f7f.json

Then /plugin install verify-skills@markdownregistry-4x4b56r3rso6wshj in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: verify-skills
description: Prove the vskills repository by linting every skill's frontmatter and relative cross-references, then running the test suite. Use before claiming this repo works, after a skill edit, or when a pull request needs verification evidence.
version: 1.0.1
---

# Verify skills

This repository is a skill catalogue and a Node installer. Proof is the command output, not a summary of it. Run both commands from the repository root. A non-zero exit is a failure. Paste the `validate-skills:` line and the test summary into the PR body.

Feature map: [frontmatter](features/frontmatter.md), [cross-references](features/cross-references.md).

## Frontmatter and cross-references

```bash
node scripts/validate-skills.mjs
```

That command lints every catalogue skill and this skill:

- frontmatter parses, with `name`, `description`, and, for catalogue skills, a semver `version`
- `name` matches the directory
- the description stays inside the routing budget
- every `dependencies` entry names a catalogue skill
- every relative markdown link inside a skill directory resolves
- every skill named in `route`'s intent table is a catalogue skill
- the body does not invoke a retired skill name

`poteto-mode`, `interrogate`, `how`, `architect`, and `ketchup` are pstack skills. They are not catalogue entries, so `route` must not list them as its destination.

## Tests

```bash
npm test
```

`npm test` runs `scripts/run-tests.mjs`, including the structural and routing evals.

## Evidence

Keep both summaries. If either command fails, verification failed. Do not start a server. There is nothing to tear down.