upstream-issue

Drafts and files verified GitHub issues to upstream projects after reproduction and duplicate checks.

3|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/MaxWolf-01/agents --skill upstream-issue-maxwolf-01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upstream-issue
Source: https://github.com/MaxWolf-01/agents/tree/main/mx/skills/upstream-issue
Command: npx skills add https://github.com/MaxWolf-01/agents --skill upstream-issue-maxwolf-01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a dependency, tool, or service turns out to be broken, undocumented, or wrong, reporting it well is hard: unverified claims waste maintainer time, duplicates add noise, and leaked hostnames or paths create privacy risk. This Skill turns a raw finding into a reproducible, privacy-checked GitHub issue that maintainers can act on. ## Core Features & Use Cases - Verification workflow: Reproduces every claim, searches existing issues (open and closed) with gh search issues, and reads the project's CONTRIBUTING and issue templates before drafting. - Minimal reproduction and redaction: Drills the bug down to a minimal case built in an empty directory, and strips hostnames, tokens, paths, and other identifying details from the report body. - Structured drafting and gated filing: Shapes the report around expected-vs-actual with evidence in <details> blocks, adds a one-line AI-disclaimer, renders a preview via the GitHub markdown API, and files with gh issue create only after explicit user approval. - Use Case: You discover a CLI tool silently drops data on a specific flag. The Skill verifies the behavior on a stated version, confirms no duplicate exists, drafts the issue in a subagent, shows you the rendered preview, and files it after your yes. ## Quick Start Report the bug I just found in the upstream repo to its maintainers as a GitHub issue.

Frequently Asked Questions about upstream-issue

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

FAQPage Schema
How do I report a bug to an upstream GitHub project?

Reproduce the issue on a stated version, search the tracker including closed issues for duplicates, and read the project's CONTRIBUTING and issue templates. Then draft a report leading with expected versus actual behavior and file it with gh issue create after review.

How to write a minimal reproduction for a bug report?

Build the reproduction in an empty directory and strip the setup one piece at a time until only what triggers the bug remains. Paste that exact directory and its output into the report so the maintainer can run the same files.

Should AI-generated issues be disclosed to maintainers?

Yes. The report opens with a one-line disclaimer stating it was AI-drafted, verified by a person before filing, and that someone answers follow-ups. This distinguishes it from unverified AI reports that maintainers increasingly reject.

How do I avoid leaking private information in a public issue?

Read the body as a stranger would and redact hostnames, paths, usernames, tokens, internal URLs, and stack traces carrying them. Building a minimal reproduction in an empty directory removes most identifying details by itself.

What if the project has issue templates or bans AI reports?

Fill the template's own fields rather than imposing a foreign structure, and respect blank_issues_enabled settings. If a project rejects AI-assisted reports, that decision is theirs and the issue should not be filed.