Skip to content

jupes/agent-forge-harness / .agents/skills/pr-description

pr-description

Unverified

Write or validate a Forge PR body using the canonical template. Use when creating or editing a PR, or checking its description.

FileKindSize
SKILL.mdskill md1.9 KB
references/pr-template.mdmarkdown1.8 KB
scripts/check-pr-body.tsscript929 B
---
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`.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall