pr-description-writer SKILL.md skillA

pr-description-writer from varnan-tech/opendirectory is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add varnan-tech/opendirectory/pr-description-writer@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
varnan-tech/opendirectory
Path
skills/pr-description-writer/SKILL.md
Versions recorded
3
Latest version
v1.0.0, committed Sep 16, 2026
First version recorded
Apr 14, 2026
Size
4,074 bytes
Repository stars
688
License
MIT

Use when the user asks to write, draft, generate, or update a GitHub pull request description for the current branch. Reads the branch diff and commit messages, writes a structured PR body (summary, changes, testing), and optionally creates or updates the PR via the gh CLI.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# PR Description Writer

Read the current branch diff and write a complete GitHub pull request description. Create or update the PR with one command.

## Writing Style

Apply to all generated PR descriptions:

- Active voice. "Adds X" not "X has been added."
- Present tense for summary ("Adds caching layer"), past tense for context ("The old approach caused N requests per render")
- Short sentences, one idea per bullet
- No em dashes — use a comma or period instead
- No filler: "this PR", "this commit", "as per the discussion"
- Specifics beat generalities: "reduces p95 latency from 800ms to 90ms" beats "improves performance"

---

## Step 1: Check Setup

Confirm `gh` is authenticated:

```bash
gh auth status
```

If not authenticated: `gh auth login` and follow the prompts.

Confirm the current directory is a git repo with an active branch:

```bash
git branch --show-current
```

If detached HEAD or no branch, stop and ask the user which branch they want to describe.

---

## Step 2: Gather Diff Context

Run all three commands to build context:

**File summary (what changed):**
```bash
git diff main...HEAD --stat
```

**Commit messages (why it changed):**
```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add varnan-tech/opendirectory/pr-description-writer@sha256:783baa22a4a6bc1b

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_s7vtkhcvccofdvs5.svg)](https://markdownregistry.com/a/art_s7vtkhcvccofdvs5)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Apr 14, 2026 and Sep 16, 2026, about one every 77 days. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-16 a03d635 4,074 BA view · diff
v1.0.02026-05-02 442742b 4,131 BA view · diff
v1.0.02026-04-14 cf4acb6 3,859 BB view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4074 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

varnan-tech/opendirectory · 688 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_s7vtkhcvccofdvs5
GET https://markdownregistry.com/api/v1/resolve?ref=varnan-tech/opendirectory/pr-description-writer
GET https://markdownregistry.com/api/v1/blob/783baa22a4a6bc1b74902c6fc3a69ef91468fd646c554489852bd5ec931d99fd

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from varnan-tech/opendirectory

app-store-review-arbitrage SKILL.md skill
varnan-tech/opendirectory · skills/app-store-review-arbitrage/SKILL.md · Fetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked…
v1.0.0 · audit A · 688 stars
blog-cover-generator SKILL.md skill
varnan-tech/opendirectory · skills/blog-cover-image-cli/SKILL.md · Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern…
git:20260522.401a5ed · audit A · 688 stars
brand-alchemy SKILL.md skill
varnan-tech/opendirectory · skills/brand-alchemy/SKILL.md · World-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA…
git:20260419.e608e58 · audit A · 688 stars
claude-md-generator SKILL.md skill
varnan-tech/opendirectory · skills/claude-md-generator/SKILL.md · Use when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a…
v1.0.0 · audit B · 688 stars
cold-email-verifier SKILL.md skill
varnan-tech/opendirectory · skills/cold-email-verifier/SKILL.md · Use when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV…
git:20260418.3202b3d · audit A · 688 stars
company-radar SKILL.md skill
varnan-tech/opendirectory · skills/company-radar/SKILL.md · Competitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs)…
v1.0.0 · audit A · 688 stars
competitor-pr-finder SKILL.md skill
varnan-tech/opendirectory · skills/competitor-pr-finder/SKILL.md · Give it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of…
git:20260916.a03d635 · audit A · 688 stars
cook-the-blog SKILL.md skill
varnan-tech/opendirectory · skills/cook-the-blog/SKILL.md · Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study…
v1.0.0 · audit A · 688 stars
dependency-update-bot SKILL.md skill
varnan-tech/opendirectory · skills/dependency-update-bot/SKILL.md · Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs…
v1.0.0 · audit A · 688 stars
docs-from-code SKILL.md skill
varnan-tech/opendirectory · skills/docs-from-code/SKILL.md · Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas…
v1.0.0 · audit A · 688 stars
domain-expired-opportunity-finder SKILL.md skill
varnan-tech/opendirectory · skills/domain-expired-opportunity-finder/SKILL.md · Evaluates expired domain candidates against a target niche, scores them by topical relevance, historical activity…
v1.0.0 · audit A · 688 stars
dx-roaster SKILL.md skill
varnan-tech/opendirectory · skills/dx-roaster/SKILL.md · Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README…
v1.0.0 · audit A · 688 stars

Every file in varnan-tech/opendirectory

Other files named pr-description-writer

pr-description-writer SKILL.md skill
mohitagw15856/pm-claude-skills · i18n/es/skills/pr-description-writer/SKILL.md · Redacta una descripción de pull request clara y estructurada a partir de un diff de git, resumen de rama o lista de…
git:20260702.b8fb11d · audit A · 1,475 stars
pr-description-writer SKILL.md skill
lethe044/agentskill-kit · skills/pr-description-writer/SKILL.md · Drafts a pull request description with a summary, motivation, a change list, test notes and risks from a diff or commit…
v1.0.0 · audit A · 48 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/claude/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/grok/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · adapters/cursor/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars
pr-description-writer SKILL.md skill
oleg-koval/agent-skills · plugins/olko-github-pr/skills/pr-description-writer/SKILL.md · Draft and post a GitHub PR title and body from git diff and commit history. Use when opening a new PR, when the user…
git:20261017.dea6b7b · audit A · 4 stars

Browse by kind, by grade A, or by owner.