outside-to-issue

name	outside-to-issue
description	Transform outside-of-diff review files into properly formatted issue files for a given PR. Use when converting review files from ai-docs/reviews-pr-<PR>/outside/ into issue format in ai-docs/reviews-pr-<PR>/issues/. Automatically determines starting issue number and preserves all metadata (file path, date, status) from original review files. Don't use for inline-diff review files, non-PR review artifacts, or creating GitHub issues directly.
metadata	{"author":"Pedro Nauck","github":"https://github.com/pedronauck","repository":"https://github.com/pedronauck/skills"}

Outside to Issue

Transform outside-of-diff review files into properly formatted issue files for PR review tracking.

Overview

This skill converts review files from the outside/ directory into standardized issue files in the issues/ directory, following the project's issue template format. The transformation preserves all metadata and automatically handles issue numbering.

Usage

Run the transformation script for a specific PR:

scripts/transform-outside-to-issues.sh --pr <PR_NUMBER>

Example:

scripts/transform-outside-to-issues.sh --pr 90

What It Does

1. Finds all outside files: Reads all .md files from ai-docs/reviews-pr-<PR>/outside/ directory
2. Determines starting issue number: Automatically finds the highest existing issue number and starts numbering from the next available number
3. Transforms each file: Converts outside review files into issue format with:
   • Issue number and title
   • File path from the review
   • Date and status
   • Body section containing the review details
   • Footer indicating it's from outside-of-diff review

File Structure

The script expects this directory structure:

ai-docs/reviews-pr-<PR>/
├── outside/
│   ├── 002-outside_01_<file-path>.md
│   ├── 002-outside_02_<file-path>.md
│   └── ...
└── issues/
    ├── 001-issue.md
    ├── 002-issue.md
    └── ...

Output Format

Each transformed issue file follows this format:

# Issue <NUMBER> - Outside-of-diff

**File:** `<file-path>`
**Date:** <date>
**Status:** <status>

## Body

<review-details-content>

---

_Generated from outside-of-diff review_

Example

For PR 90 with 18 outside files:

scripts/transform-outside-to-issues.sh --pr 90

Output:

Created: issues/026-issue.md
Created: issues/027-issue.md
...
Created: issues/043-issue.md
Transformation complete! Created issues starting from 26

Notes

• The script automatically determines the starting issue number based on existing issues
• Files are processed in sorted order (alphabetically by filename)
• All metadata (file path, date, status) is preserved from the original outside file
• The Details section content becomes the Body section in the issue file
• The script creates the issues/ directory if it doesn't exist

Related Commands

• read_pr_issues.sh - Read and display PR review issues
• resolve_pr_issues.py - Mark issues as resolved and update GitHub threads
• pr-fix command - Fix issues for a given PR