Protocol Versions

Protocol versions, migrations and the v1 upgrade — which semantics to write against, and how to change CVM behaviour without forking the network.

1 minute · 46 words · 1 sections

Install

$ npx skills add Convex-Dev/convex --skill protocol-versions

$ npx skills add Convex-Dev/convex

The first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.

Shared Convex skill

This is the Codex discovery entry for the canonical shared skill at .claude/skills/protocol-versions/SKILL.md (opens in a new tab).

Read that canonical SKILL.md completely, then follow its instructions. Resolve all relative references from the canonical skill’s directory. Keep workflow instructions in the canonical file; do not duplicate or amend them here.

About this skill

Trigger

Protocol versions, migrations and the v1 upgrade — which semantics to write against, and how to change CVM behaviour without forking the network. Use when changing core functions, juice costs, encodings or on-chain libraries.

The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.

Also published for: Claude — collapsed into this chapter because the copies are the same skill.
Source: .agents/skills/protocol-versions/SKILL.md

Colophon for this issue

Colophon

How this issue was made

Source

github.com/Convex-Dev/convex, branch develop, last pushed 21 September 2026.

Licence

Other — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.

Discovery

20 skills found by walking the repository tree for SKILL.md, not by matching a directory convention. One layout observed: .agents/skills/*/SKILL.md.

Duplicates collapsed

20 mirror copies folded into their canonical skill — republished for Claude. Copies match on content hash and on position once a leading per-agent prefix is stripped, because the same skill is routinely shipped under a dozen agent directories with a dozen different hashes.

Issue colours

Resolved from a curated brand profile — hue 80°, chroma 0.160. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to this skill so the document has one h1 and no skipped levels:

Shifted “1 heading” from h1 to h2 so the skill title is the only h1.

Spec compliance

Every skill satisfies the Agent Skills specification’s frontmatter rules.

Images

Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at , and each skill at its own URL.

/Convex-Dev/convex.md

.md