schema-bump
Automates schema versioning with mandatory breaking-change checks.
Install
mkdir -p .claude/skills/schema-bump && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12861" && unzip -o skill.zip -d .claude/skills/schema-bump && rm skill.zipInstalls to .claude/skills/schema-bump
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Safely bumps contract schema versions following compatibility rules and updates related metadata.Key capabilities
- →Automate version increments for contract schemas
- →Enforce compatibility and versioning policies
- →Apply major version bumps for breaking changes
- →Apply minor version bumps for backward-compatible changes
- →Reserve patch versions for documentation changes
- →Ensure schemas remain valid
How it works
This skill automates version increments for contract schemas by applying rules based on change types (breaking, backward-compatible, documentation-only) and updates related metadata.
Inputs & outputs
When to use schema-bump
- →Bump schema version
- →Validate contract changes
- →Update API metadata
- →Apply compatibility rules
About this skill
Schema Bump Skill
Purpose
Automates controlled version increments for contract schemas while enforcing compatibility and versioning policies defined in ADR-001.
Inputs
- Current schema version in
contracts/VERSION. - Contract schemas in
contracts/schemas/.
Outputs
- Updated version files and schemas.
- Summary of version changes.
Rules
- Breaking changes require major version bump.
- Backward-compatible changes require minor version bump.
- Patch versions are reserved for documentation or metadata-only changes.
Definition of Done (DoD)
- Version updated according to change type.
- Schemas remain valid.
- No unintentional breaking changes introduced.
When not to use it
- →When not bumping contract schema versions
- →When not enforcing compatibility rules
- →When changes are not related to schemas
Limitations
- →Limited to contract schemas
- →Requires adherence to ADR-001 policies
- →Patch versions are reserved for documentation or metadata-only changes
How it compares
This workflow explicitly enforces compatibility rules and versioning policies, preventing accidental breaking changes, which a manual version bump might overlook.
Compared to similar skills
schema-bump side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| schema-bump (this skill) | 0 | 7mo | Review | Intermediate |
| openapi-spec-generation | 22 | 2mo | No flags | Intermediate |
| microsoft-code-reference | 7 | 5mo | Review | Beginner |
| openai-knowledge | 5 | 4mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by Nepopams
View all by Nepopams →You might also like
openapi-spec-generation
wshobson
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.
microsoft-code-reference
github
Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.
openai-knowledge
openai
Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.
agent-docs-api-openapi
ruvnet
Agent skill for docs-api-openapi - invoke with $agent-docs-api-openapi
openai-docs
openai
Use when the user asks how to build with OpenAI products or APIs and needs up-to-date official documentation with citations (for example: Codex, Responses API, Chat Completions, Apps SDK, Agents SDK, Realtime, model capabilities or limits); prioritize OpenAI docs MCP tools and restrict any fallback browsing to official OpenAI domains.
http-generate
spring-ai-alibaba
Generates HTTP request examples for Spring Boot Web interfaces according to task specification and saves them as .http files in module-generate.md directories