github-issue-record

Creates GitHub bug issues via GitHub MCP and saves local triage reports.

Updated May 20, 2026
One-click install
npx skills add https://github.com/ZawilecxD/trAInR --skill github-issue-record-zawilecxd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue-record
Source: https://github.com/ZawilecxD/trAInR/tree/main/.cursor/skills/github-issue-record
Command: npx skills add https://github.com/ZawilecxD/trAInR --skill github-issue-record-zawilecxd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Filing well-structured bug reports on GitHub and keeping a local, searchable record of them is repetitive and error-prone. This Skill turns a freeform bug description into a properly formatted GitHub issue on ZawilecxD/trAInR and a matching local triage report under context/foundation/issues/. ## Core Features & Use Cases - Guided bug intake: Interviews for missing required fields (summary, steps, affected area, severity, expected vs actual) before creating anything. - Duplicate detection: Searches existing GitHub issues before creating to avoid filing duplicates. - Create and Sync modes: Create new issues from descriptions, or sync an existing issue number into a refreshed local report. - Local triage archive: Saves Markdown reports with frontmatter, screenshots, and an index README for offline tracking. - Use Case: You notice the select dropdown text is unreadable on dark theme. Invoke the skill with that description, confirm the proposed fields, and it files the GitHub issue and saves a local report in one flow. ## Quick Start Ask the assistant to file a bug on GitHub by describing the broken behavior, for example reporting that the login redirect loops after signout on the dashboard.

Frequently Asked Questions about github-issue-record

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

FAQPage Schema
How do I file a bug report on GitHub from a chat description?

Invoke the skill with a freeform bug description, and it interviews you for missing required fields like summary, steps to reproduce, affected area, and severity. After you confirm a preview, it creates the GitHub issue via GitHub MCP and saves a local report.

How do I sync an existing GitHub issue to a local report?

Pass an issue number, #N, or a full issue URL to the skill. It fetches the issue with issue_read, maps the title and body into the local report format, and refreshes the GitHub snapshot without creating a new issue.

Does the skill check for duplicate GitHub issues before creating?

Yes. Before creating, it runs search_issues scoped to repo:ZawilecxD/trAInR using keywords from the summary and affected area. If a likely duplicate is found, it shows the match and asks whether to link to it or create anyway.

Can I attach screenshots to a GitHub issue through the API?

GitHub's issue API does not accept binary uploads directly. The skill copies the image to context/foundation/issues/assets/, embeds it in the local report, and adds a comment describing the screenshot, optionally pushing the asset to the repo for a hosted URL.

What happens if the GitHub issue creation call fails?

If the issue_write call fails due to permissions or a missing label, the skill reports the error and stops without writing any local files, so no orphaned triage reports are created.