cellm/skills/versioning/SKILL.md
CELLM version control framework — apply before any version bump, release decision, or when version inflation is detected. Covers SemVer, EffVer, pre-release tags, sync protocol, and anti-inflation strategies. For deep multi-scheme guidance, use cellm:version-control.
npx skillsauth add murillodutt/cellm cellm/skills/versioningInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Is the project in production with users depending on the API?
NO -> 0.x.y (MINOR = breaking, PATCH = features + fixes)
YES -> Published library?
YES -> Strict SemVer. Batch breaking changes. Deprecate before remove.
NO -> EffVer (effort-based) or SemVer with fixed cadence.
| Signal | SemVer | EffVer (effort-based) | |--------|--------|----------------------| | Zero effort for users | PATCH | MICRO | | Some adaptation effort | MINOR | MESO | | Significant migration effort | MAJOR | MACRO | | Pre-production, unstable API | Stay on 0.x.y | Stay on 0.x.y |
AI compresses dev cycles — refactors that took weeks now happen in hours. This causes MAJOR inflation. Counter with: 0.x.y pre-stable, batch breaking changes, pre-release tags (-alpha, -beta, -rc).
One version, one reality. Source of truth: VERSION file.
| Artifact | Syncs from VERSION |
|----------|--------------------|
| package.json | cellm:bump skill |
| plugin.json (all plugins) | cellm:bump skill (auto-discovered) |
| marketplace.json | cellm:bump skill |
| VERSION.md | cellm:bump skill |
| Project-specific targets | ~/.cellm/bump/bump-{project}.json → versionTargets[] |
Plugin or package versioning can be independent per namespace; follow each project's release contract.
cellm:bump skill to sync all targetsVERSION file first, then decide increment-alpha, -beta, -rc for unstable workdata-ai
Prose override — temporarily disable quantization and respond in readable prose. Use when relational density matters, for safety-critical explanations, onboarding handoffs, or when token economy is not the priority.
development
Govern explicit weekly Super PRs or maintainer-requested PR merges. Evaluates a 10-criterion readiness checklist and performs governed merge only when a user-requested PR is READY. Never creates or keeps permanent PRs. Use when: 'pr-check', 'pr-merge', 'merge this PR safely', 'is PR ready', 'guard merge', or /sk-git delegates pr-merge.
data-ai
Operational surface for the compress-llm Layer-1 token I/O compressor. Enable, disable, switch mode, and inspect status without editing config files. Use when tuning compression pressure for the current session or project.
tools
Generate structured upstream feedback for the CELLM engineering team. Produces evidence-first Markdown at docs/evidence/<date>-cellm-feedback-*.md for bugs, anti-patterns, deprecation gaps, and harness surprises, with optional atom registration via knowledge_ops. Use when: 'feedback for CELLM', 'send to CELLM team', 'register this as atom', 'document this anti-pattern', 'report this bug upstream'. Trigger proactively on MCP schema/runtime mismatches, mechanical edit loops (>=3 sequential edits), short deprecation windows (<6 weeks), or reusable harness surprises. Do NOT trigger for routine feature work or project-local bugs.