IN PLAIN ENGLISH
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.
This is aimed at Developers maintaining readable project history. Compare the examples below with your task, then review the limitations, permissions, and risks before installing.
- Infer change intentRead the diff to identify what changed, why, and the affected scope.
- Write the commit storyCreate an imperative subject plus optional rationale and issue references.
- Recommend splitsSeparate unrelated concerns when one diff contains several logical changes.
- Improves commit history by preserving intent rather than restating filenames.
- Handles breaking changes, issue references, and logically separate work.
No verified review text is in the current dataset. Use the linked source for the latest discussion.
Read the source note ↗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.
npx skills add github/awesome-copilot --skill commit-message-storyteller --agent github-copilotnpx skills add github/awesome-copilot --skill commit-message-storyteller --agent github-copilot -gProject install stays with this repository for team sharing. Personal install adds -g and works across repositories.
View install paths
.agents/skills/commit-message-storyteller/~/.copilot/skills/commit-message-storyteller/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
Infer change intent
Read the diff to identify what changed, why, and the affected scope.
Write the commit story
Create an imperative subject plus optional rationale and issue references.
Recommend splits
Separate unrelated concerns when one diff contains several logical changes.
THE TRADEOFFS
Advantages and tradeoffs
Notable strengths
- Improves commit history by preserving intent rather than restating filenames.
- Handles breaking changes, issue references, and logically separate work.
Limitations
- A diff often cannot reveal the true motivation, user impact, or issue context.
- 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
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.
COMMON QUESTIONS
Commit Message Storyteller Skill FAQ
What is the Commit Message Storyteller Skill?
Narrative Conventional Commit messages that explain intent, impact, and logical change boundaries. 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.
How do I install the Commit Message Storyteller Skill?
Open and review the listed source, choose the project or personal path for your Agent, then verify the first run in a controlled project. Open the pinned commit and read the current SKILL.md.
Is the Commit Message Storyteller Skill safe to use?
SkillSignal checked the source on 2026-09-24, but that is not a runtime test or security certification. Review the “Incorrect intent inferred from code” risk first and begin with the least access required.
INSIDE THE PACKAGE
Indexed files
TAGS
Original SkillSignal editorial profile grounded in GitHub Awesome Copilot commit d7e4ad98, checked 2026-09-23; not independently executed or security-certified.