smaqit.release-prepare-files

Validate Git state and finalize CHANGELOG.md and version files.

3|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/ruifrvaz/smaqit-extensions --skill smaqit-release-prepare-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smaqit.release-prepare-files
Source: https://github.com/ruifrvaz/smaqit-extensions/tree/main/.github/skills/smaqit.release-prepare-files
Command: npx skills add https://github.com/ruifrvaz/smaqit-extensions --skill smaqit-release-prepare-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the crucial pre-release steps of validating your Git repository's state and ensuring all necessary files, like the CHANGELOG and version files, are correctly updated and consistent.

Core Features & Use Cases

  • Git State Validation: Checks for a clean working tree and correct branch for releases.
  • Changelog Finalization: Updates the CHANGELOG.md with the new version and date, and ensures comparison links are correct.
  • Version File Synchronization: Optionally updates version numbers in common files (e.g., package.json, pyproject.toml) for consistency.
  • Use Case: Before deploying a new version, this skill ensures your release notes are accurate and your project's version is updated across all relevant files, preventing common release errors.

Quick Start

Use the smaqit.release.prepare-files skill to validate the git state and finalize the changelog and version files for the upcoming release.

Frequently Asked Questions about smaqit.release-prepare-files

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

FAQPage Schema
How do I validate my Git repository state before a release?

To validate your Git repository state before a release, you need to ensure the working tree is clean and verify you are on the correct branch. This prevents committing unintended changes and secures the release baseline.

How do I finalize a CHANGELOG.md file for an upcoming version release?

Finalizing a CHANGELOG.md involves updating the document with the approved version number and current release date, while verifying that version comparison links are accurate for users navigating release notes.

How do I synchronize version numbers across project files like package.json and pyproject.toml?

Synchronizing version numbers across project files requires updating version strings in configuration files like package.json and pyproject.toml. This ensures versioning consistency across all project dependencies and metadata.

What is the best way to automate pre-release file preparation and Git checks?

Automating pre-release file preparation involves scripting Git state validation, changelog finalization, and version file synchronization. This approach eliminates manual errors and enforces consistent release readiness across your DevOps pipeline.

Can I use release preparation automation without a clean Git working tree?

Release preparation automation requires a clean Git working tree to proceed safely. Uncommitted changes can cause inconsistent releases, so the process validates the repository state before finalizing changelogs or version files.