Skip to content

craft-github-release

skillLast commit

Agent skill for Codex and Claude Code that turns verified repository evidence into trustworthy GitHub release notes and releases.

Open productSource
Role
Agent workflow design and automation engineering
Scope
Agent workflow, validation automation, and packaging
Status
Published npm package

Problem

Commit logs are implementation-centric and can lead release authors to omit user impact, invent compatibility, or choose the wrong comparison boundary.

Constraints

  1. C1

    Tag/version/range ambiguity can materially change the release.

  2. C2

    Only user-visible changes supported by commits, diffs, issues, or changelogs belong in notes.

  3. C3

    Creating/editing a GitHub release is a remote mutation distinct from drafting.

Architecture

Git/tag/diff evidence collector; release-note rules and drafting workflow; optional GitHub release adapter with explicit output/validation report.

01

Skill workflow

Git/tag/diff evidence collector.

02

Automation

Release-note rules and drafting workflow.

03

Verification

Optional GitHub release adapter with explicit output/validation report.

Decisions

D1

Resolve target and comparison boundary before prose

Resolve target and comparison boundary before prose.

D2

Separate breaking changes from ordinary improvements

Separate breaking changes from ordinary improvements and qualify inferred impact.

D3

Keep drafting read-only

Keep drafting read-only and gate remote release creation independently.

Contribution

  • Built release evidence collection.
  • Codified note structure and evidence rules.
  • Implemented uncertainty and authorization checkpoints.
  • Packaged portable installers and tests for release behavior.

Outcomes

  • Agents can turn repository history into scoped notes.
  • Exclude unsupported names/compatibility/test claims.
  • Flag breaking changes.
  • Hand off final notes or an authorized release URL with evidence.

Verified stack

  • Agent Skills
  • JavaScript
  • Node.js
  • npm
  • GitHub Actions
  • CI/CD
  • Git

Working through something similar?

Share your challenge, scope, and timeline to start a focused conversation.