PR Etiquette SKILL.md skillA

PR Etiquette from costajohnt/oss-autopilot is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add costajohnt/oss-autopilot/PR Etiquette@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
costajohnt/oss-autopilot
Path
skills/pr-etiquette/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Oct 25, 2026
First version recorded
Apr 25, 2026
Size
8,883 bytes
Repository stars
28
License
MIT

This skill should be used when responding to maintainer review feedback, writing or reviewing PR descriptions, following up on dormant PRs, validating PR quality before submission, or deciding how to communicate with maintainers. Sibling to oss-contribution and contribution-ethics.

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 Etiquette

How to communicate around a pull request — review responses, descriptions, follow-up cadence, and the readiness gate. Pair with the `oss-contribution` skill (universal rules) and `contribution-ethics` (attribution + AI-tell avoidance).

## Responding to Code Review Feedback

### Mindset

Maintainer feedback is a gift — they're investing time to help you improve. Even critical feedback should be received gracefully.

### Response Approach

- Address every point they raise
- Keep it short. One or two sentences is usually enough.
- Push updates promptly after discussion
- Mark conversations as resolved after addressing
- If you feel resistance to a request, investigate deeper — the maintainer likely knows something you don't. If you still think there's an issue after investigating, raise it to the human contributor — never override the maintainer

### Assumptions and Verification

When a maintainer requests changes, these rules govern how you respond:

1. **Maintainer is right by default.** If a maintainer says "do X," your starting assumption is that X is correct and appropriate for their codebase. Do not second-guess their judgment about their own project.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add costajohnt/oss-autopilot/PR Etiquette@sha256:7056755ea6f6f794

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_mruu6cvqfpkxx4w3.svg)](https://markdownregistry.com/a/art_mruu6cvqfpkxx4w3)

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

Versions

The registry has recorded 5 versions of this file, between Apr 25, 2026 and Oct 25, 2026, about one every 46 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-10-25 6b17337 8,883 BA view · diff
v1.0.02026-10-12 330a604 8,743 BA view · diff
v1.0.02026-05-08 e57c1a8 8,621 BA view · diff
v1.0.02026-04-26 0512459 8,246 BA view · diff
v1.0.02026-04-25 8a754ae 7,446 BA 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 (8883 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

costajohnt/oss-autopilot · 28 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mruu6cvqfpkxx4w3
GET https://markdownregistry.com/api/v1/resolve?ref=costajohnt/oss-autopilot/PR Etiquette
GET https://markdownregistry.com/api/v1/blob/7056755ea6f6f794f57536ce994e92fdea1e41a30745134d4929c33e5b982884

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 costajohnt/oss-autopilot

CLAUDE.md CLAUDE.md file
costajohnt/oss-autopilot · CLAUDE.md
git:20261102.acb56c8 · audit A · 28 stars
Contribution Ethics SKILL.md skill
costajohnt/oss-autopilot · skills/contribution-ethics/SKILL.md · This skill should be used when writing commits, PRs, or comments that will be visible to OSS maintainers — it covers…
v1.0.0 · audit A · 28 stars
OSS Contribution Best Practices SKILL.md skill
costajohnt/oss-autopilot · skills/oss-contribution/SKILL.md · This skill should be used when the user is working on open source contributions, responding to maintainer feedback…
v2.0.0 · audit A · 28 stars

Every file in costajohnt/oss-autopilot

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