pr-description-skill

Solid

Use this skill to write the PR description (PR body) for any pull request opened against microsoft/apm. Produces one self-sufficient GitHub-Flavored Markdown artifact: TL;DR, Problem (WHY), Approach (WHAT), Implementation (HOW), 1-3 validated mermaid diagrams, explicit trade-offs, validation evidence, and a How-to-test section -- with every WHY-claim backed by a verbatim quote from PROSE or Agent Skills. Activate when the user asks to "write a PR description", "draft a PR body", "open a PR", "fill in the PR template", or any equivalent.

AI & Automation 2,852 stars 235 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# PR Description Skill -- Anchored, Concise, Validated PR Bodies ## When to use Trigger this skill on any of the following intents: - "write a PR description" - "draft a PR body" - "open a PR" / "open this PR" / "let's open the PR" - "fill in the PR template" - "summarize this branch as a PR" - "create the PR write-up" Reusable for any PR against `microsoft/apm`. The output is one markdown file that the orchestrator pastes into `gh pr create --body-file` or surfaces to the maintainer. ## Output charset rule (read this first) The repo-wide encoding rule at `.github/instructions/encoding.instructions.md` constrains **source files and CLI output** to printable ASCII because Windows cp1252 terminals raise `UnicodeEncodeError` on anything else. PR comments are NOT source code and NOT CLI output -- they are rendered by GitHub's Primer engine, which expects UTF-8 GitHub-Flavored Markdown. Two distinct rules therefore apply: 1. **Source files in this bundle** (`SKILL.md`, `assets/*`) MUST stay ASCII. They live in the repo and are subject to `.github/instructions/encoding.instructions.md`. 2. **The PR body output the skill produces** MUST be UTF-8 GitHub-Flavored Markdown. Use em dashes, smart punctuation, alerts, collapsibles, task lists, and Unicode where it improves readability. Mermaid diagram labels MAY use Unicode -- there is no constraint here. The output is consumed by GitHub's renderer, not by a Windows terminal. A previous version of this skill ...

Details

Author
microsoft
Repository
microsoft/apm
Created
8 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category