generate-analysis-report - SKILL.md Agent Skill

name: generate-analysis-report description: Compile bug fix proposals and validation results into a markdown report. Use this after running bug-analyzer and fix-validator on multiple PRs.

Generate Analysis Report Skill

This skill compiles all analysis results into a summary markdown report.

Usage

Run the report.sh script:

./report.sh [--input-dir <path>] [--output <file>]

Parameters

Parameter	Required	Description	Default
`--input-dir`	No	Directory containing analysis folders	`data/analysis`
`--output`	No	Output file path	`data/analysis-results.md`

Example

# Generate report from all analyses
./.github/skills/generate-analysis-report/report.sh

# Custom paths
./.github/skills/generate-analysis-report/report.sh \
  --input-dir ./my-analyses \
  --output ./report.md

Expected Input Structure

The script expects the following structure:

data/analysis/
├── 12345/                        # PR number
│   ├── metadata.json             # PR-level metadata
│   ├── issue.md                  # Bug issue description
│   ├── actual_fix/               # Real solution
│   │   ├── pr-diff.patch
│   │   ├── pr.md
│   │   └── changed-files.txt
│   └── claude-opus-4.6-2026-02-21/  # Experiment results
│       ├── proposed-fix.md
│       └── validation.md
├── 12346/
│   └── ...

Output Format

The report includes:

Summary Statistics
- Total PRs analyzed
- Average alignment score
- Score distribution
Results Table | PR # | Issue # | Proposed Fix Summary | Alignment Score | Key Findings |
Detailed Breakdown (optional)
- Each PR's full analysis

Prerequisites

jq for JSON processing
Analysis directories with metadata.json