release

Automate Elixir library releases with versioning, changelog updates, and pull requests.

7|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/andreashasse/spectral --skill release-andreashasse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/andreashasse/spectral/tree/main/.claude/skills/release
Command: npx skills add https://github.com/andreashasse/spectral --skill release-andreashasse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and error-prone process of preparing and creating new releases for software libraries, ensuring consistency and adherence to best practices.

Core Features & Use Cases

  • Version Management: Analyzes changes to suggest appropriate semantic version bumps (major, minor, patch).
  • Changelog & Documentation Updates: Guides the user through updating CHANGELOG.md and README.md to reflect new versions and features.
  • Quality Assurance: Executes essential build and test commands (mix format, mix compile, mix test, mix credo, mix dialyzer, mix docs) to ensure code quality.
  • Release Branching & Committing: Creates a dedicated release branch and commits all prepared changes.
  • Pull Request Generation: Drafts a pull request with a clear title and description based on changelog entries, ready for review and merging.
  • Use Case: A developer needs to release a new version of their Elixir library. This Skill helps them determine the correct version number, update the changelog, run all tests, and prepare a pull request for the release, significantly reducing the manual effort and potential for errors.

Quick Start

Initiate the release process by running the release skill to prepare for a new version.

Frequently Asked Questions about release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Elixir library versioning and changelog updates for a new release?

Automating Elixir library releases involves analyzing code changes to suggest semantic version bumps, updating CHANGELOG.md and README.md, running quality checks, and preparing a pull request. This Skill handles that entire workflow using Mix and Git.

What's the best way to prepare a semantic version release for an Elixir Mix project?

Preparing a semantic version release for an Elixir Mix project is best done by following Keep a Changelog standards, running mix test and mix credo, creating a dedicated release branch, and drafting a pull request, which this Skill fully automates.

Does this release automation Skill work with Elixir Mix and GitHub CLI?

Yes, this release automation Skill requires Elixir with the Mix build tool, Git for version control, and the GitHub CLI for pull request creation to manage versioning, documentation, and quality checks.

Can I automatically generate a changelog and pull request for my Elixir library?

Yes, you can automatically generate a changelog and pull request for your Elixir library. This Skill drafts a pull request with a clear title and description derived from your Keep a Changelog entries, ready for review and merging.

What Elixir quality checks are run before creating a release branch?

Before creating a release branch, the Elixir quality checks executed include mix format, mix compile, mix test, mix credo, mix dialyzer, and mix docs to ensure code quality and documentation standards are met.