SpectreSkills
← All recipes
★

clean-git-workflow

v1.0.0

Keep a repository's history and release notes clean and legible — conventional commits, scannable PR descriptions, and a maintained changelog. Combine on any project where commit and release hygiene matters.

Git & GitHubgitgithubworkflow
Install the whole recipe
npx @spectre-apps/skills recipe clean-git-workflow

Installs all 3 skills into .claude/skills. Add --user to install globally.

Or add them individually
npx @spectre-apps/skills add conventional-commits pr-description changelog-keeper

3 skills, in order

  1. 01
    conventional-commitsv1.0.0

    Write commit messages in the Conventional Commits format. Trigger when composing a git commit, squashing, or writing a changelog entry.

  2. 02
    pr-descriptionv0.2.0

    Draft a clear pull request description from the current diff. Trigger when opening a PR or asked to summarize a branch of changes.

  3. 03
    changelog-keeperv0.1.0

    Maintain a Keep a Changelog style CHANGELOG.md. Trigger when a change ships or the user asks to update the changelog.

How it fits together

Clean Git Workflow

A small bundle that makes a repo's history tell a clear story — from each commit through the PR to the changelog.

Order

  1. conventional-commits — format every commit as <type>(<scope>): <summary> so history is parseable and releases can be derived from it.
  2. pr-description — turn a diff into a scannable What / Why / How / Testing writeup that leads with the user-visible effect.
  3. changelog-keeper — roll the accepted changes into a Keep a Changelog CHANGELOG.md, grouped Added/Changed/Fixed/Removed.

Together they give you a straight line from an individual change to a released, documented version — no archaeology required.

Prefer to drop the files in?

Copies every skill in this recipe as one block — each section is headed with the path it belongs at (.claude/skills/<slug>/SKILL.md), so you can paste them straight into your project and reference them in your prompt.