Educational Pr Description

Educational PR/MR Descriptions — Agent Skill

A portable "skill" that teaches coding agents (Claude Code, Cursor, Codex, etc.) to add a **Context & Patterns** section to pull/merge request descriptions.

The goal: help less experienced reviewers — or engineers reviewing across the stack (backend reviewing frontend, vice versa) — understand *why* the code is written the way it is, not just *what* changed.

Works for both GitHub PRs and GitLab MRs. The skill's activation trigger covers both.

What is a "skill"?

A skill is a markdown file with YAML frontmatter that agents load to gain narrow, on-demand capabilities. The `description` field tells the agent when to invoke it. Works with any agent framework that supports the Anthropic "Agent Skills" convention (`.claude/skills/`, `~/.agents/skills/`, Cursor skills, etc.).

Install

One-liner

curl -fsSL https://raw.githubusercontent.com/matldupont/educational-pr-description/main/install.sh | bash

Install to Claude Code user skills instead:

curl -fsSL https://raw.githubusercontent.com/matldupont/educational-pr-description/main/install.sh | bash -s -- claude

Install project-local (commit to share with your team):

cd your-project
curl -fsSL https://raw.githubusercontent.com/matldupont/educational-pr-description/main/install.sh | bash -s -- project

Manual

Drop `SKILL.md` into one of:

• User-wide (all projects): ~/.agents/skills/educational-pr-description/SKILL.md
• Claude Code user-wide: ~/.claude/skills/educational-pr-description/SKILL.md
• Project-local: .claude/skills/educational-pr-description/SKILL.md

Then just ask your agent to write or improve a PR/MR description and the skill will activate automatically.

How to use it

There are two main ways to use this skill.

1. Direct invocation

Just ask your agent something that mentions PRs, MRs, or writing a description. The `description` field in the frontmatter triggers activation:

• *"Wr