---
title: /skill:prd
description: Pi-adapted PRD synthesis and optional GitHub issue publishing.
---

# /skill:prd

**Status:** pi-adapted.

Turns the current conversation and codebase understanding into a Product Requirements Document, optionally publishes it as a GitHub issue, and saves a local copy.

## Usage

```text
/skill:prd
```

## Behavior

- Synthesizes existing context; it does not run a requirements interview.
- Reads domain docs via `skills/grill-docs/reference/domain-docs.md`.
- Writes `docs/ai/<slug>/<slug>-prd.md`.
- Uses `skills/issues/reference/github-issues.md` for `gh` conventions.
- Uses `ask_user` only when deciding whether to update an existing issue or create a new one.

## Output

Local PRD artifact, optional GitHub issue URL, and a `**Tracking:** <URL>` line in the PRD when publishing succeeds.