jupes/agent-forge-harness / .agents/skills/pr-description
pr-description
UnverifiedWrite or validate a Forge PR body using the canonical template. Use when creating or editing a PR, or checking its description.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.9 KB |
| references/pr-template.md | markdown | 1.8 KB |
| scripts/check-pr-body.ts | script | 929 B |
SKILL.md
View on GitHub---
name: pr-description
description: Write or validate a Forge PR body using the canonical template. Use when creating or editing a PR, or checking its description.
---
# pr-description
The single source of truth for **how every Agent Forge PR body is written**. All ship paths
(`/ship`, `/forge-ship`, `/forgemaster`'s ship phase) compose the PR body from this template and
validate it before `gh pr create`.
The template lives at [references/pr-template.md](references/pr-template.md) — edit that file to
change the standard; everything else references it.
Read [the canonical template](references/pr-template.md) before drafting or checking a body; it defines every required section.
## Process
### 1. Start from the template
```bash
cp .claude/skills/pr-description/references/pr-template.md .tmp/work/pr-body.md
```
Fill every section. For a `/forge-ship` run, the ship report (`reports/<slug>-ship.md`) already
contains the narrative and walkthrough — map it into the template sections rather than duplicating
prose. Paste **actual** test output into `## Test Evidence`; never green-wash.
### 2. Validate before creating the PR
```bash
bun run .claude/skills/pr-description/scripts/check-pr-body.ts .tmp/work/pr-body.md
```
The validator emits `{ ok, data: { present, missing, empty }, error }` and exits non-zero if any
required section is missing or left as a placeholder. Fix and re-run until `ok: true`.
### 3. Open or update the PR
```bash
gh pr create --base <base> --title "<title>" --body-file .tmp/work/pr-body.md
# or, on an existing PR:
gh pr edit <n> --body-file .tmp/work/pr-body.md
```
To check a PR that already exists:
```bash
gh pr view <n> --json body -q .body | bun run .claude/skills/pr-description/scripts/check-pr-body.ts -
```
## Exit Criteria
- [ ] PR body contains all six required sections, each filled.
- [ ] `## Test Evidence` holds real output, not a promise.
- [ ] `check-pr-body.ts` reports `ok: true`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |