Conventional Commit and PR Description Writer Skill (SKILL.md)

A ready-to-save SKILL.md that makes your coding agent write Conventional Commits messages and pull request descriptions from the staged diff, never from guesses.

You get: A filled-in template

More like this

Ready to use: no blanks to fill in.

The prompt

Installs to .agents/skills/conventional-commit-and-pr-description-writer-skill-skill-md/

mkdir -p .agents/skills/conventional-commit-and-pr-description-writer-skill-skill-md && curl -sL "https://prompts-gpt.com/prompts/conventional-commit-and-pr-description-writer-skill-skill-md/raw" -o .agents/skills/conventional-commit-and-pr-description-writer-skill-skill-md/SKILL.md
SKILL.md
Preview
---
name: conventional-commit-and-pr-description-writer-skill-skill-md
description: "A ready-to-save SKILL.md that makes your coding agent write Conventional Commits messages and pull request descriptions from the staged diff, never from guesses."
---

# Conventional Commit and PR Description Writer Skill (SKILL.md)

A ready-to-save SKILL.md that makes your coding agent write Conventional Commits messages and pull request descriptions from the staged diff, never from guesses.

## Prompt

```
---
name: commit-and-pr-writer
description: Writes Conventional Commits messages and pull request descriptions from the actual diff. Use when the user asks to commit, write a commit message, open or describe a pull request, or summarise staged changes.
---

# Commit and PR writer

## Commit message
1. Run `git status` and `git diff --staged`. If nothing is staged, show the unstaged files and ask what to stage. Never stage everything without asking.
2. If the diff mixes unrelated changes, propose splitting it into separate commits and list which files go in each.
3. Pick the type: feat, fix, refactor, perf, test, docs, build, ci or chore. Add a scope when one package or area is touched.
4. Subject: imperative mood, under 72 characters, no trailing period.
5. Body: why the change was needed, then what changed, wrapped at 72 characters. Add `BREAKING CHANGE:` with migration notes when a public interface changes.
6. Footer: issue references found in the branch name or diff, such as `Closes #123`.

## Pull request description
1. Run `git log --oneline` and `git diff` against the base branch.
2. Fill in the repo's pull request template if one exists.
3. Sections: Summary, Changes (grouped by purpose), How to test (numbered commands), Risks and rollback.

## Output format
Show the message or description in a code block and wait for approval before running `git commit` or creating the PR.

## Stop and ask
- The reason for the change is not clear from the diff or commits.
- The diff contains secrets, credentials or large generated files.
- Hooks fail. Report the failure; never bypass hooks with --no-verify.

## Risks
Describing changes that are not in the diff. Re-read the diff before finalising.
```

## Usage Notes

Save as .claude/skills/commit-and-pr-writer/SKILL.md in a repo, or ~/.claude/skills/commit-and-pr-writer/SKILL.md for every project. Claude Code loads it when the description matches; the same file works in Codex, Cursor and Gemini CLI, which also read SKILL.md.

Tips and common edits

Save as .claude/skills/commit-and-pr-writer/SKILL.md in a repo, or ~/.claude/skills/commit-and-pr-writer/SKILL.md for every project. Claude Code loads it when the description matches; the same file works in Codex, Cursor and Gemini CLI, which also read SKILL.md.

Questions about this prompt

More in Claude Code

Pre-Merge Code Review Checklist Skill (SKILL.md)

A save-ready SKILL.md that has your coding agent review a branch before merge: correctness, security, tests and migrations, with findings ranked by severity and no style nitpicks.

Release Notes From Git Log Skill for Users and Developers (SKILL.md)

A SKILL.md that writes release notes from the commits between two tags, split into a plain-language section for users and a technical changelog for developers.

Test-First Bug Fix Skill: Reproduce, Fix, Prove (SKILL.md)

A SKILL.md that forces your coding agent to reproduce a bug with a failing test before changing code, apply the smallest fix, and prove it with the test suite.

Brand Voice Guard Skill That Checks Drafts Against VOICE.md (SKILL.md)

A SKILL.md that makes Claude write and edit in your brand's voice: it reads a VOICE.md in the project, or builds one from samples, then checks every draft against it.

Meeting Notes to Decisions and Action Items Skill (SKILL.md)

A SKILL.md that turns any meeting transcript or rough notes into a decision log, owner-and-date action items, open questions and a ready-to-send recap email.

Spreadsheet and CSV Cleanup Report Skill (SKILL.md)

A SKILL.md that has your agent profile a messy CSV or spreadsheet, fix it in a copy with a script, and report every change so the cleaned data can be trusted.

Write a SKILL.md From a Workflow You Keep Repeating

Interviews you about a task you do over and over, then writes a complete, save-ready SKILL.md with a trigger description, steps, output format and stop conditions.

Codex Writes an AGENTS.md for This Repository From the Real Setup

Has Codex inspect your repository and write a short, accurate AGENTS.md with the real build, test and lint commands, conventions and boundaries, checked by actually running them.

Characterization Tests Before a Refactor

Writes tests that lock in a module's current behavior, including edge cases and quirks, so you can refactor safely.

Codebase Tour for a Specific Task

Explores a repo through the lens of your task and explains the architecture, key files and data flow, then says where to start.

Failing Test First Bug Fix

Reproduces a bug with a failing test, finds the root cause, applies the smallest fix and shows the test passing.

Recurring Workflow to SKILL.md with Trigger, Steps and Verification

Claude Code interviews you briefly about a repeated workflow and writes a complete SKILL.md with a precise trigger description, steps, supporting files and a verification step.