📝
WritingPython

PR Description

by microsoft

PR Description is a Writing skill for Claude Code, published by microsoft in apm.

3.5K stars324 forkson microsoft/apmAdded 2026/08/16+1% in starsRepository updated 2026/08/15
ai-agentsclaude-codecodex-clicontext-engineeringgithub-copilotpackage-managerprompt-engineering
Install in seconds
Install PR Description
Copy PR Description into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/microsoft/apm/tree/main/packages/pr-description-skill ~/.claude/skills/pr-description-skill

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/microsoft/apm.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
packages/pr-description-skill/SKILL.md in microsoft/apm
Installs to
~/.claude/skills/pr-description-skill
Collection
One of 21 skills cataloged from this repository
Category
Writing1012 skills

What PR Description does

PR Description drafts a self-sufficient GitHub-Flavored Markdown pull request body with TL;DR, problem, approach, implementation, validated mermaid diagrams, trade-offs, validation evidence, and how-to-test sections. Use it when asked to write a PR description, draft a PR body, open a PR, or fill in a PR template.

PR Description is cataloged under Writing on DirSkills. PR Description comes from a repository tagged ai-agents, claude-code, codex-cli, context-engineering and github-copilot.

Documentation

README

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)

This is the opening of the README. Read the full README on GitHub.

Frequently asked about PR Description

  • What else does microsoft publish alongside PR Description?

    PR Description is one of 21 skills that DirSkills catalogs from microsoft/apm, the repository it ships in. Its siblings there include APM Issue Autopilot, APM Review Panel and APM Spec Guardian. Each one is a separate skill with its own page in this directory, installs the same way PR Description does, and is maintained by microsoft in that same repository. The rest of the collection is listed on the microsoft/apm page.

  • How does PR Description compare to other Writing skills?

    PR Description ranks #177 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of PR Description against them. Open each page to compare what they document and how they install.

More from microsoft/apm

PR Description is one of 21 skills cataloged on DirSkills from microsoft/apm.

See all 21 skills
🚦
2w ago

APM Issue Autopilot

APM Issue Autopilot drives any open microsoft/apm issue from raw intake to a mergeable PR with triage as the central gate. It batches issues, runs the triage panel per issue, presents one consolidated review, escalates by default, and only auto-implements clear, bounded accepts approved by the maintainer.
AI Engineering
3.5K324
🧑‍⚖️
2w ago

APM Review Panel

APM Review Panel runs a fan-out panel of specialist agents to review a labelled pull request in microsoft/apm. It aggregates findings from mandatory and conditional specialists plus a CEO synthesizer, then writes one advisory recommendation comment (no verdict labels, no merge gating). Use when a non-trivial PR needs cross-cutting recommendation on architecture, CLI logging, DevX UX, supply-chain
Quality
3.5K324
🛡️
2w ago

APM Spec Guardian

APM Spec Guardian runs a four-panel adversarial advisory review on pull requests that touch the OpenAPM specification, schemas, or conformance fixtures, returning a ship recommendation keyed off a shocked_meter scale. Use it when a PR changes normative spec artifacts and needs expert panel findings before a maintainer decides to ship.
Quality
3.5K324
📦
2w ago

APM Starter

APM Starter is a starter package for Agent Package Manager that demonstrates how to create reusable agent primitives like instructions, prompts, and agents. Use it to bootstrap new APM packages or learn the structure.
AI Engineering
3.5K324
📣
2w ago

APM Strategy

APM Strategy guides product positioning, release communication, community-facing artifacts, and breaking-change decisions. Activate it when editing README, manifests, changelogs, release workflows, or issue templates.
Writing
3.5K324
🧠
2w ago

APM Triage Panel

APM Triage Panel orchestrates multiple specialist personas to triage a single GitHub issue in the microsoft/apm repository, producing a synthesized comment with a triage decision, label set, milestone, and suggested next action.
AI Engineering
3.5K324