---
title: /skill:issues
description: Pi-adapted GitHub issue slicing from a PRD, plan, spec, or current context.
---

# /skill:issues

**Status:** pi-adapted.

Breaks a PRD, plan, spec, or current context into independently grabbable GitHub issues using vertical slices.

## Usage

```text
/skill:issues
/skill:issues https://github.com/owner/repo/issues/42
/skill:issues docs/ai/my-feature/my-feature-prd.md
```

## Behavior

- Gathers source context from the argument or conversation.
- Reads domain docs via `skills/grill-docs/reference/domain-docs.md`.
- Drafts thin vertical slices, not horizontal layer tasks.
- Uses `ask_user` to approve or adjust the breakdown.
- Publishes issues in dependency order when `gh` is available.
- Saves a local index to `docs/ai/<slug>/<slug>-issues.md`.

## Output

GitHub issues when publishing succeeds, plus a local issue index artifact.
