github-issue

Create GitHub issues from templates with linked context and Mermaid diagrams.

1|Updated Jan 24, 2021
One-click install
npx skills add https://github.com/leighmcculloch/dotfiles --skill github-issue-leighmcculloch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue
Source: https://github.com/leighmcculloch/dotfiles/tree/main/files/claude/skills/github-issue-create
Command: npx skills add https://github.com/leighmcculloch/dotfiles --skill github-issue-leighmcculloch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines GitHub issue creation by automatically selecting templates, incorporating diagrams for proposals, and aggregating context from linked issues and PRs to ensure clarity and consistency.

Core Features & Use Cases

  • Template discovery: checks the target repository for issue templates under .github/ISSUE_TEMPLATE and, if needed, the organization's template repository to find the best match.
  • Context aggregation: reads linked issues/PRs to surface relevant details in the new issue.
  • Proposal diagrams: generates a Mermaid diagram illustrating current versus proposed states for architectural or process changes.
  • Draft generation and review: writes a draft NOTES_ISSUE.md for user review before issue creation.

Quick Start

Provide the repository, title, and brief context, and I will draft a GitHub issue using the best available template.

Frequently Asked Questions about github-issue

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

FAQPage Schema
How do I create GitHub issues using repository templates automatically?

To create GitHub issues using templates automatically, this Skill discovers issue templates under .github/ISSUE_TEMPLATE in the target repository, or the organization's template repository, and drafts an issue matching the best available template for you to review.

Can I include context from linked issues and pull requests in a new GitHub issue?

Yes, you can include context from linked issues and pull requests. This Skill aggregates context by reading linked issues and PRs, surfacing their relevant details directly within the newly drafted GitHub issue to ensure clarity and consistency.

How to generate Mermaid diagrams for GitHub issue proposals?

You generate Mermaid diagrams for GitHub issue proposals by providing brief context about an architectural or process change. This Skill optionally generates a Mermaid diagram illustrating the current versus proposed states and embeds it in the draft.

Does this Skill draft GitHub issues for review before submitting them?

Yes, this Skill drafts GitHub issues for review before submitting. It generates a NOTES_ISSUE.md file containing the aggregated context, template, and diagrams, allowing you to review the draft issue before final creation.

What is the best way to write a feature request on GitHub with architectural context?

The best way to write a feature request with architectural context is using automated template discovery, linked PR context aggregation, and Mermaid diagram generation. This ensures your proposal clearly illustrates current versus proposed states.

Do I need custom templates to create GitHub issues with diagrams and linked context?

You do not need custom templates to create GitHub issues with diagrams and linked context. The Skill automatically discovers existing templates in your repository or organization, aggregates linked content, and generates proposal diagrams independently.