Do I need the GitHub CLI installed?

Yes, the skill requires the gh CLI to be installed and authenticated to interact with your repository's issues and PRs.

Can I customize the PR description format?

Yes, the skill uses a templates/pr-body.md file which can be modified to match your team's specific documentation standards.

How does the skill know which task I'm working on?

It automatically detects the task ID from your branch name (e.g., impl/1/1.1) or looks up the information in the .impl/manifest.json file.

What is specification-driven development in this context?

It refers to a workflow where code implementation is strictly mapped to predefined plans, proposals, and architectural records to ensure software alignment with business goals.

Does it create the PR for me?

By default, it generates the description for your review, but using the --create flag will execute the GitHub PR creation command immediately.

Structured PR Generator

Name: Structured PR Generator
Author: alexnodeland

byalexnodeland

•

协作工具

Generates comprehensive pull request descriptions by mapping implementation changes back to architectural plans, ADRs, and project proposals.

This skill automates the creation of high-context pull request descriptions within a specification-driven development workflow. By analyzing the current implementation branch and cross-referencing it with Domain-Driven Design (DDD) plans, task manifests, and Architecture Decision Records (ADRs), it produces a structured PR body that includes summaries, checklists, and direct links to tracking issues. It is particularly valuable for teams using Claude Code to maintain rigorous traceability between their code changes and high-level architectural requirements, ensuring that reviewers have all the necessary context without manual data entry.

主要功能

013 GitHub stars

02Automatic context detection from branch naming conventions and manifests

03Deep integration with GitHub CLI for issue and PR management

04Automated branch analysis to summarize changed files and commit history

05Template-based PR body generation for consistent documentation

06Cross-references implementation changes with ADRs and DDD plans

使用场景

01Standardizing PR descriptions across a team to improve code review efficiency

02Ensuring every PR includes mandatory links to proposals and design decisions

03Opening a new pull request for a specific task within a larger architectural plan

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled pr-describe

For use in Claude.ai and ChatGPT

Download Skill