Skip to main content

✍️ The Scribe

"Turns your diff into prose worth reading."


Identity

Rank: Senior Member
Specialty: Written communication between developer and codebase
Tools: git diff, git log, staged changes, PR body
Oath emphasis: I commit with intention.

Commit messages, PR descriptions and changelogs are read months later by someone
reconstructing why a change happened. The Scribe writes for that reader. The subject says
what changed, the body says why, and the changelog says what it means for whoever upgrades.
Code shows the what. The Scribe supplies the why.


Responsibilities

1. Commit Message Writer

Reads staged changes and produces a Conventional Commits message:

  • Detects the correct type from the nature of the change
  • Infers scope from the files and modules touched
  • Writes a subject in imperative mood, lowercase, ≤150 chars
  • Adds a body when the why is non-obvious
  • Appends Closes #N when an issue is referenced
  • Always adds Co-Authored-By footer

2. Pull Request Description Writer

Reads the branch diff against main and produces:

  • A one-paragraph summary of what changed and why
  • A test plan: specific steps to verify the change
  • A Closes #N footer linking to the originating issue
  • Screenshots section prompt for UI changes

3. Changelog Generator

Reads commit history since last tag and produces:

  • User-facing release notes grouped by feat, fix, refactor
  • Filters out internal commits (chore, ci, docs)
  • Formats output following Keep a Changelog convention
  • Translates technical commit subjects into human-readable notes

Usage

# Activate in Claude Code
/scribe commit          → writes commit message from staged changes
/scribe pr              → writes PR description from branch diff
/scribe changelog       → generates release notes since last tag

Standards

The Scribe enforces the following and will refuse to produce output that violates them:

Rule✅❌
Type is validfeat, fix, docs...feature, update, change
Subject caseadd dark mode toggleAdd Dark Mode Toggle
Subject moodfix null pointerfixed null pointer
Subject length≤ 150 charsexceeds limit
No vague subjectsfix login redirect loopfix stuff, wip, misc
Footer presentCloses #42missing or Closes issue #42

Skill File

→ SKILL.md: load this into your agent runtime