skills.rest
bponghneng
bponghnengCOMMUNITY
Explore all skills by this author →
GitHub

review-spec

Generate structured specification documents from GitHub PR review comments.

Updated Dec 5, 2025
Search Tags:#automation#code review#pull request#github#specification#ai feedback
One-click install
npx skills add https://github.com/bponghneng/rouge --skill review-spec-bponghneng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-spec
Source: https://github.com/bponghneng/rouge/tree/main/.agents/skills/review-spec
Command: npx skills add https://github.com/bponghneng/rouge --skill review-spec-bponghneng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typer, python-dotenv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of converting unstructured GitHub PR review comments, particularly those generated by AI tools like CodeRabbit, into structured, actionable specification documents.

Core Features & Use Cases

  • Automated Spec Generation: Parses AI-generated review prompts from GitHub PRs into organized specification documents.
  • Structured Feedback: Organizes feedback by severity and provides clear "Fix Instructions."
  • Workflow Integration: Designed to fit seamlessly into AI coding workflows, enabling faster issue resolution.
  • Use Case: After an AI code review flags several issues in a pull request, this Skill can generate a clear, concise specification document that an AI agent can then use to implement the necessary fixes efficiently.

Quick Start

Generate a specification from PR #94 review comments.

Frequently Asked Questions about review-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert GitHub PR review comments into structured specifications?▼

To convert GitHub PR review comments into structured specifications, this Skill parses unresolved feedback blocks and organizes them by severity. It extracts AI-generated prompts to create clear fix instructions for efficient issue resolution.

Can I parse AI-generated CodeRabbit feedback from pull requests?▼

Yes, you can parse CodeRabbit feedback from pull requests using this Skill. It specifically targets AI-generated review blocks in GitHub PRs, extracting the content and organizing it into actionable specification documents.

How do I organize unresolved PR comments by severity for AI agents?▼

You organize unresolved PR comments by severity by running this Skill's automated extraction process. It categorizes the review feedback and generates AI agent prompts designed for seamless integration into coding workflows.

Do I need Python and typer to generate specs from GitHub PR comments?▼

Prerequisites include a Python environment with the typer and python-dotenv dependencies installed. You need this environment configured to authenticate with GitHub and access the pull request review comments you want to process.

How do I create AI agent prompts from GitHub pull request feedback?▼

You create AI agent prompts from GitHub pull request feedback by passing the PR data through this Skill. It automatically structures the unresolved review comments into actionable specifications for AI-driven issue verification and resolution.

What are the limitations when automating spec generation from PR review comments?▼

This Skill is limited to processing unresolved GitHub PR review comments and specifically parses AI-generated feedback blocks. It does not handle general code analysis or extract feedback from non-GitHub repository platforms.

Related Skills

Explore More Software Engineering Skills→
risosachrisosach

fetch-unresolved-comments

Fetch unresolved GitHub pull request review comments via GraphQL API.

Community
Intermediate
syedsaif666syedsaif666
14

workflow

Enforce a structured plan-to-pull-request workflow for AI-generated code changes.

Community
Advanced
Luney-IndustriesLuney-Industries
4

address-pr-comments

Categorize GitHub pull request comments and generate action plans.

Official
Advanced
aaronbassettaaronbassett
4

pr-tools:address-review

Fetch GitHub PR review comments, categorize issues by severity, and plan resolutions.

Community
Intermediate