Skip to content

chore: add release skill#82

Merged
akonwi merged 1 commit intomainfrom
chore/release-skill
Apr 5, 2026
Merged

chore: add release skill#82
akonwi merged 1 commit intomainfrom
chore/release-skill

Conversation

@akonwi
Copy link
Copy Markdown
Owner

@akonwi akonwi commented Apr 5, 2026

Summary

Adds a release skill at .agents/skills/release/SKILL.md that covers the full release flow:

  1. Pick the next version — survey commits since the last tag, apply semver rules
  2. Tag and pushgit tag v… and push to origin
  3. Wait for CI — watch the Release Binaries workflow (build.yml) to build darwin/linux × amd64/arm64 binaries and auto-create the GitHub release
  4. Draft notes — defers to the existing release-notes skill for tone, structure, and categories
  5. Publishgh release edit on the release the workflow already created

Why both skills

  • release-notes stays focused on the notes-only flow — useful when a release already exists and only the notes need updating/rewriting.
  • release orchestrates the whole thing for the common case where you're cutting a new version from scratch.

Key invariants documented

  • Never tag from a feature branch
  • Never call gh release create (CI already creates the release; manual calls would race)
  • Wait for all workflow jobs (test, build ×4, release) before editing notes

Adds a skill that covers the full release flow: picking the next
version, tagging and pushing, waiting for the Release Binaries CI
workflow to create the GitHub release, then drafting and publishing
release notes.

Complements the existing release-notes skill, which remains the
notes-only flow for updating an already-published release.
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ard-lang-dev Ready Ready Preview, Comment Apr 5, 2026 7:59pm

@akonwi akonwi merged commit ce03e96 into main Apr 5, 2026
4 checks passed
@akonwi akonwi deleted the chore/release-skill branch April 5, 2026 20:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant