create-issue

Create GitHub Issues with labels and duplicate checks via gh CLI.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/macrat/markdown-board --skill create-issue-macrat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-issue
Source: https://github.com/macrat/markdown-board/tree/main/.claude/skills/create-issue
Command: npx skills add https://github.com/macrat/markdown-board --skill create-issue-macrat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation of GitHub Issues by ensuring they align with product philosophy, checking for duplicates, and applying appropriate labels and structure.

Core Features & Use Cases

  • Structured Issue Creation: Generates well-formatted Issues for bugs, enhancements, documentation, and questions.
  • Product Philosophy Alignment: Validates feature proposals against core principles to prevent feature bloat.
  • Duplicate Checking: Prevents redundant Issues by searching existing issues and ADRs.
  • Use Case: When a user reports a bug, this Skill will automatically create a bug report Issue with the bug and created-by-ai labels, including steps to reproduce and expected behavior.

Quick Start

Use the create-issue skill to create a bug report for a login issue.

Frequently Asked Questions about create-issue

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

FAQPage Schema
How do I create GitHub Issues with structured bodies and appropriate labels?

To create GitHub Issues with structured bodies and labels, use this Skill to generate well-formatted bug reports, feature enhancements, documentation updates, and questions automatically. It applies appropriate labels like `bug` and `created-by-ai` using the `gh` CLI.

How does duplicate checking work for GitHub issue creation?

Duplicate checking for GitHub issue creation works by searching existing issues and Architecture Decision Records to prevent redundant submissions. This ensures new issues are unique and avoids cluttering the repository with duplicate bug reports or feature proposals.

Can I validate feature proposals against product philosophy before creating a GitHub issue?

Yes, you can validate feature proposals against product philosophy before creating a GitHub issue. This Skill checks alignment with core principles to prevent feature bloat, ensuring only proposals that fit the product vision proceed to issue creation.

Do I need the gh CLI to create GitHub issues with this automation tool?

Yes, you need the `gh` CLI installed to create GitHub issues with this automation tool. The Skill utilizes the GitHub command line interface to generate structured issue bodies and apply appropriate labels directly to your repository.

What's the best way to automate bug report creation on GitHub?

The best way to automate bug report creation on GitHub is using this Skill to generate structured issues with steps to reproduce and expected behavior. It automatically applies bug labels and checks for existing duplicate issues before submission.

Why does my GitHub issue creation fail when checking ADRs?

GitHub issue creation might fail during ADR checks if the `glob` pattern cannot locate your Architecture Decision Records directory. Ensure your ADR files are properly formatted and accessible so the duplicate checking mechanism can validate feature proposals correctly.