update-ovfx

Bump OVFX spec versions and update schema, examples, tests, and changelog.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/openperimetry/ovfx-spec --skill update-ovfx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-ovfx
Source: https://github.com/openperimetry/ovfx-spec/tree/main/.claude/skills/update-ovfx
Command: npx skills add https://github.com/openperimetry/ovfx-spec --skill update-ovfx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The OVFX specification requires consistent governance-led version bumps; this skill automates the end-to-end process to raise a new spec version, update related schema and examples, regenerate validator registry, tests, and changelog, and open a PR for review.

Core Features & Use Cases

  • Automates a full OVFX spec bump: copy current spec and schema to a new version, adjust meta, and regenerate related artifacts.
  • Updates examples, tests, and validator registry to ensure compatibility with the new version.
  • Generates a PR with a detailed change description and notes for maintainers.

Quick Start

Follow the CLAUDE.md procedure to create a new OVFX spec version and open a PR with the changes.

Frequently Asked Questions about update-ovfx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bump a specification to a new version and update the schema?

To bump a spec version, copy current spec and schema to a new version, adjust metadata, and regenerate related artifacts like examples, tests, and the validator registry within the ovfx-spec repository.

What does a governance-driven version bump procedure include?

A governance-driven version bump includes determining the bump type (major, minor, or patch), creating the new version, and preparing a PR with detailed change descriptions, rationale, and notes for maintainers.

When do I need to regenerate the validator registry during a version bump?

You need to regenerate the validator registry during a version bump to ensure compatibility with the new version, alongside updating examples and tests to maintain validation integrity across the updated schema.

How do I prepare a PR for a new spec version with changelog updates?

To prepare a PR for a new spec version, execute the full versioning procedure to update the spec, schema, examples, tests, and changelog, then generate the PR with notes and rationale for review.

Does the spec bump process automatically determine major, minor, or patch versions?

Yes, the spec bump process determines the bump type (major, minor, or patch) automatically as part of the governance-driven procedure to create a new version and prepare the PR.