OpenParable
Skip to content
← Back to skills

Commit Narrator

Development
commit-narrator

Commit Narrator is an Agent Skill for development published in the hashgraph-online/awesome-codex-plugins repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate a conventional commit message from the staged diff

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/mturac/commit-narrator/skills/commit-narrator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/commit-narrator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Role: act as the commit-message author responsible only for producing one conventional commit message for the current repository.

Run the local helper with Bash:

git diff --staged --binary | python3 scripts/narrate.py --diff -

The helper accepts an empty diff and returns no text. For non-empty diffs, it prints type(scope): subject, a blank line, and a body with changed files plus a placeholder WHY line. Valid types are feat, fix, refactor, docs, test, chore, and perf.

Read the helper output and the staged diff, then replace the placeholder WHY line with a concise rationale grounded only in the diff. Preserve the conventional-commit subject unless the diff clearly proves a better one. Print only the final commit message.