Skip to content
Get packs

Commit Message Storyteller

Writes Conventional Commits messages that explain why a git change was made

Source Download skill
Repository
github/awesome-copilot
Stars
40,703
Licence
MIT
Files
2 files

What it does

When you ask the agent to write a commit message, it reads your git diff or a description of your changes and drafts a commit message in the standard Conventional Commits format. The message has a short typed subject line, a body explaining the reason for the change rather than just listing edits, and optional footers such as issue references or breaking-change notes. It does not run git commit itself; it only writes the text for you to use.

Great for

  • Developers who want clearer, more useful commit history for a team or open-source project
  • Anyone preparing a pull request who wants meaningful commit messages
  • Developers who find it hard to summarise their changes in one line

Skip it if

  • Projects that do not use Conventional Commits, since the output format will not match their conventions
  • Situations where you want the agent to stage files and commit automatically; this skill only drafts text and points to a separate git-commit skill for that
  • Commits where the reason for the change is unknown: the skill infers intent from the diff, so it may invent a plausible but wrong 'why' that needs checking

Try asking

  • “Write a commit message for my staged changes”
  • “Summarize my diff and suggest a commit type”
  • “What should I commit this as? Here is my git diff output”
  • “Describe my changes as a conventional commit that closes issue #312”
Step-by-step guide: how to use Commit Message StorytellerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    commit-message-storyteller.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip commit-message-storyteller.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip commit-message-storyteller.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Paste the output of git diff --staged and add a sentence explaining why you made the change, so the story is accurate
  • Mention the issue number if one exists so the footer can reference it
  • Review the generated 'why' before committing, since the agent may guess the motivation from code alone

What's inside

  • references/conventional-commits-guide.md
  • SKILL.md

Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.