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.

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 — edit that file to change the standard; everything else references it.

Read the canonical template before drafting or checking a body; it defines every required section.

Process

1. Start from the template

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

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

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:

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: 196kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall