feat(skills): add bumping-opencoder-versions project skill - #63
Merged
Conversation
Adds .agents/skills/bumping-opencoder-versions/SKILL.md covering the four Renovate-blind version surfaces in this repo: 1. OpenCode core (.opencode-version + .opencode-checksums via scripts/bump-version.sh) 2. npm plugins in opencode.json + tui.json (with plugin-alignment invariant) 3. skills.sh CLI pin in markdown docs (4 files) 4. skills-lock.json content hashes (regenerate via skills CLI) Includes per-surface procedures, the 7-day embargo fallback policy (matches Renovate's minimumReleaseAge behavior), two-tier verification protocol (validate.sh always; build/test only with explicit user OK), common-mistake/rationalization tables, and live-tested jq recipes. Validated by executing the skill end-to-end against the repo in PR #62.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Promotes the
bumping-opencoder-versionsskill from user-level (~/.agents/skills/) to a project-level skill at.agents/skills/bumping-opencoder-versions/SKILL.md. This ships the bumping playbook with the repo so it's available to anyone (human or agent) working on opencoder.Why
The skill was authored and iteratively refined against this repo (PR #62) and is project-specific — it has no use outside
tankdonut/opencoder. User-level was fine for first authoring; project-level is the right home for ongoing maintenance.Coverage
Four Renovate-blind version surfaces (Renovate owns the rest via
config:recommended):.opencode-version+.opencode-checksums)scripts/bump-version.shopencode.json+tui.json(with alignment invariant)jq --indent 4editskills@X.Y.Zpin in markdown docs (4 files)sed -iacross all fourskills-lock.jsoncomputedHashvaluesPlus:
minimumReleaseAgebehavior — fall back to latest eligible, don't skip)validate.shalways;build.sh+container-test.shonly with explicit user OK (5–20+ min each)jqdefaults to 2-space indent → noisy diff; latest version embargoed → skip is wrong, fall back is right)Validation
validate.shgreenFollow-ups considered and rejected
build/skills-lock.json: rejected, that's for skills.sh registry skills from external repos, not project-local skillsAGENTS.mdto mention the skill: deferred — can be a follow-up if the convention emerges that project skills should be enumerated there