review-issue

Triage external GitHub issues and gate-enabled PRs to assign or decline.

27.1k|2.2k|Updated Nov 30, 2024
One-click install
npx skills add https://github.com/PrefectHQ/fastmcp --skill review-issue-prefecthq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-issue
Source: https://github.com/PrefectHQ/fastmcp/tree/main/.claude/skills/review-issue
Command: npx skills add https://github.com/PrefectHQ/fastmcp --skill review-issue-prefecthq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review an incoming external issue (and any gated-closed PR behind it) and decide whether to assign the contributor or decline. Use when the maintainer says "look at this issue", "review issue #N", "should we take this", or asks whether to assign someone. Assigning the author auto-reopens their PR for normal review. This is the entry point for incoming-issue triage — distinct from review-pr, which responds to bot reviews on your own open PR.

Core Features & Use Cases

  • Assign the author to an external issue when the contribution is valid and a referenced PR exists, causing the PR to reopen for review.
  • Decline and explain why if the issue or PR does not meet project gate requirements, with guidance to maintainers.
  • Provide a structured triage workflow that reads issue/PR metadata, checks gate conditions, and applies appropriate GitHub actions (assignee, reopen, or comment).

Quick Start

Provide the issue number and repository context to triage, then let the skill determine whether to assign or decline.

Frequently Asked Questions about review-issue

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

FAQPage Schema
How do I automate GitHub issue triage for external contributors?

Automated GitHub issue triage evaluates external issues to decide whether to assign the contributor or decline, reading issue metadata and applying actions like assigning the author or commenting with an explanation.

Can I automatically reopen a pull request when assigning an issue author?

Yes, assigning the external issue author automatically reopens their gated-closed pull request for normal review, streamlining the contributor onboarding workflow.

What is the best way to decline an invalid external issue on GitHub?

Declining an invalid external issue involves evaluating gate conditions and applying a GitHub action to close or comment with a structured explanation guiding maintainers on why requirements were not met.

Does automated issue triage work with gated pull requests?

Yes, automated issue triage specifically applies to gate-enabled pull requests, evaluating the referenced PR context to determine whether to assign the author and reopen it or decline with feedback.

When should I use automated issue triage instead of manual pull request review?

Use automated issue triage when maintainers are asked to review incoming external issues like "look at this issue", distinct from manual pull request review which responds to bot reviews on your own open PR.