GitHub Bug Report Triage

Evaluate GitHub issues for bug reports only. Determine if they contain sufficient info to be actionable. If not, identify missing details and provide constructive feedback.

Workflow

1. Locate Issue Template

Check for existing templates:

• .github/ISSUE_TEMPLATE/bug_report.md

• .github/ISSUE_TEMPLATE/bug_report.yml

• .github/ISSUE_TEMPLATE/*.md

• .github/ISSUE_TEMPLATE.md

• ISSUE_TEMPLATE.md

If no template exists, use references/ISSUE_TEMPLATE.md from this skill as the fallback template, then evaluate the issue against it.

2. Evaluate Issue Quality

Critical questions:

Is this a bug report?

• If the issue is a feature request or a question, do not evaluate this issue

Is the description clear?

• What's broken or wrong

• Expected behavior vs. what actually happens

• Impact or severity

Can we reproduce it?

• Step-by-step reproduction

• OR sandbox/StackBlitz/CodeSandbox link

• OR minimal code example

Be reasonable:

• Don't require every template field to be filled

• Focus on minimum info needed to investigate

• Consider context (obvious bugs vs. edge cases)

3. Make Determination

Ready to be actionable:

• Has clear problem description

• Includes reproduction path OR enough context to debug

• Actually a bug (not feature/question)

Needs more info:

• Vague description ("it doesn't work")

• Missing reproduction steps AND no code example

• Unclear what the expected behavior should be

• Missing critical context (e.g., "crashes" but no error message)

4. Provide Feedback

If ready: Confirm issue is actionable.

If needs info: Specify what's missing. Be constructive and specific.

Examples

Example 1: Ready to Investigate

Issue: Dropdown menu doesn't close on mobile Safari

Description: When clicking a dropdown menu item on iOS Safari, the menu stays open instead of closing. Works fine on desktop Chrome/Firefox.

Steps:

1. Visit https://stackblitz.com/edit/my-repro
2. Open on iOS Safari
3. Click dropdown, select any item
4. Menu stays open (should close)

Environment: iOS 16.3, Safari

Evaluation: ✅ Ready

• Clear description

• Has reproduction link

• Specific environment details

Example 2: Needs More Info

Issue: Button is broken

Description: The submit button doesn't work properly.

Evaluation: ❌ Needs info Missing:

• What does "doesn't work" mean? (no click? error? wrong behavior?)

• Expected vs. actual behavior

• Steps to reproduce

• Any error messages

Example 3: Edge Case - Reasonable

Issue: Console error on form submit

Description: Getting "Cannot read property 'value' of null" when submitting the contact form. Happens 100% of the time.

Error:

TypeError: Cannot read property 'value' of null at handleSubmit (ContactForm.tsx:45)

Environment: Chrome 120, Windows 11

Evaluation: ✅ Ready

• Clear error message with stack trace

• Specific file/line reference

• Reproducible (100% of time)

• Note: No explicit repro steps, but error is clear enough to investigate

Example 4: Bug Report with Insufficient Reproducibility

Issue: [glob-loader] Duplicate id warning on file update

Description: I'm encountering an issue with the glob loader. Whenever I update the watched file, I get a warning message in the logs.

The warning message:

13:23:31 [WARN] [glob-loader] Duplicate id "russian-test" found in /path/to/project/content/posts/russian-test.md. Later items with the same id will overwrite earlier ones.

Expected: No warning message

Link to Minimal Reproducible Example: - N/A

Evaluation: ❌ Needs info

• Describes a real bug (warning message)

• Has error output and code reference

• BUT: No minimal reproduction provided

• Code link points to private repo (can't access to debug)

Missing:

• Minimal reproduction (example code or link to a working reproduction)