create-github-issue

Create GitHub issues with Motivation and Acceptance Criteria via gh CLI.

2|Updated Aug 20, 2024
One-click install
npx skills add https://github.com/theZMC/dotfiles --skill create-github-issue-thezmc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-github-issue
Source: https://github.com/theZMC/dotfiles/tree/main/.agents/skills/create-github-issue
Command: npx skills add https://github.com/theZMC/dotfiles --skill create-github-issue-thezmc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams create well-structured GitHub issues that include a Motivation, Acceptance Criteria, and optional References, guaranteeing consistent issue formatting when collaborating across repositories.

Core Features & Use Cases

  • Generates an issue body with a mandatory Motivation and Acceptance Criteria section plus optional References.
  • Automatically derives a descriptive title from the provided Motivations and criteria to improve traceability.
  • Guides users through repo discovery, input gathering, and using the GitHub CLI to file or open issues.

Quick Start

Create the GitHub issue with a structured title and body using gh as soon as the required fields are collected.

Frequently Asked Questions about create-github-issue

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

FAQPage Schema
How do I create structured GitHub issues with motivation and acceptance criteria?

To create structured GitHub issues, this skill prompts you for a Motivation and Acceptance Criteria, then formats and files the issue using the gh CLI. It automatically generates a descriptive title from your inputs to improve traceability across repositories.

Do I need the gh CLI installed to automate GitHub issue creation?

Yes, you need the gh CLI installed and authenticated to use this GitHub issue creation automation. The skill relies entirely on the gh CLI to validate your inputs and file or open the structured issues in your target GitHub repository.

Can I automatically infer the repository context when creating a GitHub issue?

Yes, you can infer repository context automatically when creating a GitHub issue. The skill derives the target repository from your local git remote configuration if available, streamlining the issue filing process without manual repository specification.

What is the best way to standardize GitHub issue formatting across multiple repositories?

The best way to standardize GitHub issue formatting is to enforce a predefined body structure with mandatory Motivation and Acceptance Criteria sections. This guarantees consistent issue formatting and clear project management traceability when collaborating across repositories.

How do I add optional references and project associations to a GitHub issue?

To add optional references and project associations to a GitHub issue, the skill includes an optional References section in the generated body format. It guides you through input gathering to associate the structured issue with relevant project milestones.