verify-skills · v1.1.0 · 2026-10-23 · sha256 3e9c8550d85c4fcc

verify-skills v1.1.0A

Immutable. This exact content never changes and is served at /api/v1/blob/3e9c8550d85c4fcc.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_4x4b56r3rso6wshj/3e9c8550d85c4fcc824e384f69d2cd28351d275606fb87ecc1f9dfaadf58ef50.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.1.0
---

# 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), [routing](features/routing.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`, `why`, `recall`, `teach`, `tdd`, `architect`, `ketchup`, `setup-pstack`, `create-verification-skill`, and `maintain-verification-skill` 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. A routing failure shows as one test line. Run `node scripts/run-evals.mjs --verbose` to see each miss.

On Windows without Developer Mode, three tests that create file symlinks fail with `EPERM`. That is the environment, not the change: confirm the failing names are only the symlink tests.

## Evidence

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