GitHub, Git & DevOps · IN-DEPTH PROFILE

commit-message-storyteller

Narrative Conventional Commit messages that explain intent, impact, and logical change boundaries.

Best for

Developers maintaining readable project history

What you get

Infer change intent + Write the commit story

Main limitation

A diff often cannot reveal the true motivation, user impact, or issue context.

First risk

Incorrect intent inferred from code. The generated narrative may confidently attribute a reason the diff does not establish. Confirm the motivation, issue reference, scope, and breaking-change status before committing.

EVIDENCE FRESHNESS

Three checks, kept separate

A recent source check is not a runtime test or security audit.

Upstream sourceChecked 2026-08-20

Pinned revision · 318066d2

Open pinned commit
SkillSignal profileEditorial metadata

Updated 2026-08-20

Runtime & securityNot independently verified

Source review does not certify behavior or safety.

30-SECOND BRIEF

What it does—and when it fits

Commit Message Storyteller is a GitHub Awesome Copilot workflow that turns diffs or change descriptions into Conventional Commit messages explaining why a change exists, what problem it solves, and whether the diff should be split into multiple logical commits.

INSTALL BY AGENT

Choose your Agent

Paths come from official Agent docs or the universal installer behind skills.sh. Compatibility still follows this Skill's record.

Native

This Skill's current record explicitly names this Agent. Still inspect scripts, permissions, and external dependencies first.

Project scope.agents/skills/commit-message-storyteller/
Personal scope~/.copilot/skills/commit-message-storyteller/

Use project scope for team sharing and personal scope across repositories. The installer defaults to project scope; add -g for personal scope.

Install command (project scope)npx skills add github/awesome-copilot --skill commit-message-storyteller --agent github-copilot
Official agent docs

Copilot also accepts .github/skills and .claude/skills at project scope. Preview untrusted Skills before enabling scripts.

View path evidence

TYPICAL WORKFLOW

A practical workflow

01

Infer change intent

Read the diff to identify what changed, why, and the affected scope.

02

Write the commit story

Create an imperative subject plus optional rationale and issue references.

03

Recommend splits

Separate unrelated concerns when one diff contains several logical changes.

THE TRADEOFFS

Advantages and tradeoffs

Notable strengths

  1. Improves commit history by preserving intent rather than restating filenames.
  2. Handles breaking changes, issue references, and logically separate work.

Limitations

  1. A diff often cannot reveal the true motivation, user impact, or issue context.
  2. The Skill drafts messages but does not itself prove the changes are tested or safe to commit.

BEST FIT

Who it is for

Developers maintaining readable project history

Teams standardizing Conventional Commit messages

BEFORE YOU USE IT

Risks to review before use

Medium

Incorrect intent inferred from code

The generated narrative may confidently attribute a reason the diff does not establish. Confirm the motivation, issue reference, scope, and breaking-change status before committing.

SECURITY

What the permission profile means

  • Review diffs for secrets before pasting them into external chat services.
  • Do not include confidential issue details in public commit history.

Not a security certification. External ratings are attributed references. SkillSignal has not independently executed or security-reviewed this Skill.

INSIDE THE PACKAGE

Indexed files

SKILL.mdUpstream package contentSource-linked
references/conventional-commits-guide.mdUpstream package contentSource-linked

TAGS

gitconventional-commitswriting

Original SkillSignal editorial profile grounded in GitHub Awesome Copilot commit 318066d2, checked 2026-08-20; not independently executed or security-certified.