file-issue

Creates GitHub issues via gh CLI using a standardized body template.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/rpmcdougall/claude-skills --skill file-issue-rpmcdougall
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: file-issue
Source: https://github.com/rpmcdougall/claude-skills/tree/main/skills/file-issue
Command: npx skills add https://github.com/rpmcdougall/claude-skills --skill file-issue-rpmcdougall

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Scope creep and untracked observations derail pull requests. This Skill captures out-of-scope findings as properly structured GitHub issues so nothing gets lost and PRs stay focused. ## Core Features & Use Cases - Standardized Issue Template: Generates issues with Motivation, Scope, Non-goals, Relates to, and Phase sections matching the project's conventions. - Duplicate Detection: Checks open issues via gh issue list before filing to avoid redundant tickets. - Scope-Creep Guardrail: Enforces a strict rule that any observation outside the current PR's scope becomes a filed issue rather than unplanned work. - Use Case: During a code review you notice a refactoring opportunity unrelated to the current branch. Invoke this Skill to file it as a tracked issue with proper non-goals, then continue the PR uninterrupted. ## Quick Start File a GitHub issue for the caching bug we just discussed using the standard project template.

Frequently Asked Questions about file-issue

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

FAQPage Schema
How do I create a GitHub issue from the command line?▼

Use gh issue create with a --title and --body flag. This Skill wraps that command with a heredoc body following a fixed template of Motivation, Scope, Non-goals, Relates to, and Phase sections, then returns the issue URL.

How to avoid duplicate GitHub issues when filing?▼

Run gh issue list --state open before creating a new issue to scan for existing matches. This Skill performs that duplicate check as a mandatory step before filing anything.

What should a good GitHub issue template include?▼

A strong template includes a Motivation section explaining why, Scope bullets defining what is covered, Non-goals stating what is explicitly excluded, Relates to links for connected issues, and a Phase label for planning.

Can this Skill close or comment on existing GitHub issues?▼

No. The Skill only creates new issues and never closes or comments on existing ones as a side effect. This boundary is an explicit rule to prevent unintended modifications to the issue tracker.

When should I file an issue instead of fixing something in my PR?▼

File an issue whenever an observation falls outside the current PR's scope. The Skill enforces this strictly: out-of-scope findings become tracked issues with defined non-goals rather than unplanned additions to the branch.