change-writing

Drafts commit, pull-request, and squash messages from verified repository evidence.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/Codeseys-Labs/agentic-sdlc --skill change-writing-codeseys-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-writing
Source: https://github.com/Codeseys-Labs/agentic-sdlc/tree/main/plugin/skills/change-writing
Command: npx skills add https://github.com/Codeseys-Labs/agentic-sdlc --skill change-writing-codeseys-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing accurate commit messages, PR descriptions, and squash messages is error-prone: agents invent test results, guess issue links, ignore the repository's own conventions, and leak AI attribution trailers into history. This Skill turns verified repository evidence into proposed change-message text while enforcing a strict output-only boundary. ## Core Features & Use Cases - Evidence-based authoring: Every claim is routed through a six-step evidence ladder (verified diff, gate results, repo policy, observed history, linked work items, generic fallback); unsupported claims are omitted or marked with a TODO placeholder. - Four message modes: Commit messages, pull-request title/body scoped to the merge-base footprint, squash messages that synthesize the final delta, and audits of existing draft messages. - Convention and attribution policy: Detects and preserves repo-native commit conventions (Conventional Commits is only a fallback) and default-prohibits model/tool attribution trailers, generated-by footers, and badges unless explicitly requested. - Use Case: After finishing a feature branch, ask for a PR description; the Skill reads the verified diff and actual test output, follows the repo's PR template, and proposes title and body text — without ever running git or gh commands itself. ## Quick Start Ask the agent to draft a commit message or PR body for the current verified diff, and it will propose text only while you retain control of committing and publishing.

Frequently Asked Questions about change-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a good commit message from a diff?

Author from the verified diff first: an imperative subject line describing the change's effect, then a body explaining why. Follow the repository's detected prefix convention; use Conventional Commits only as a fallback when no local convention exists.

How should a pull request description be scoped?

Describe the merge-base footprint — the cumulative delta between the branch and the base branch's current tip — not just the HEAD diff of the last commit. Include Summary, Verification, and Risks sections, omitting any section lacking real evidence.

Does this skill commit or create pull requests automatically?

No. It is output-only: it proposes message text and never runs git add, commit, push, gh pr create, merge, rebase, or deploy commands. The human caller or an authorized skill performs and owns every publication action.

Are Co-Authored-By Claude or generated-by footers allowed in commit messages?

No. Model, tool, and provider attribution is default-prohibited, including Co-Authored-By trailers naming AI agents, generated-by footers, and badges. A real human co-author trailer backed by genuine contribution evidence remains allowed.

When should Conventional Commits be used for commit messages?

Only as a fallback when no repo-native convention is detectable in history or policy files. If the repository has its own types or prefixes, that local convention wins, and a configured commitlint setup overrides the generic specification.

What happens when evidence for a claim is missing?

The claim is either omitted entirely or replaced with a concrete TODO placeholder for the caller to resolve. The skill never fills gaps with plausible prose or invents test results, issue links, risks, or user impact.