open-github-issue

Publish structured GitHub issues with authentication fallback and JSON output.

4|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/LaiTszKin/apollo-toolkit --skill open-github-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: open-github-issue
Source: https://github.com/LaiTszKin/apollo-toolkit/tree/main/open-github-issue
Command: npx skills add https://github.com/LaiTszKin/apollo-toolkit --skill open-github-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a reliable, end-to-end method to publish structured GitHub issues and feature proposals without embedding authentication or repository-resolution logic in every workflow, reducing manual steps and errors.

Core Features & Use Cases

  • Resolve the target repository from a specified owner/name or from the current git origin.
  • Detect the target repository's language from its README to localize issue headers and formatting.
  • Publish with a strict authentication fallback: gh CLI, then GitHub token, then a draft-only output when auth is unavailable.
  • Return a machine-readable JSON payload detailing mode, issue URL, rendered body, and any publish errors for downstream automation.

Quick Start

Provide prepared issue details to publish a structured GitHub issue or draft when authentication is unavailable.

Frequently Asked Questions about open-github-issue

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

FAQPage Schema
How do I automate publishing structured GitHub issues from a workflow?

Automating GitHub issue publishing is handled by resolving the target repository, composing language-appropriate issue bodies, and using an authentication fallback. It returns a machine-readable JSON payload detailing the mode, issue URL, and publish errors for downstream workflows.

What happens when I try to create a GitHub issue but authentication is unavailable?

When GitHub issue authentication is unavailable, the system uses a draft-only fallback after exhausting gh CLI and token-based API attempts. It outputs the rendered issue body within a JSON payload instead of failing, retaining the prepared content.

Can I localize GitHub issue formatting based on the target repository's language?

Localizing GitHub issue formatting is supported by detecting the target repository's language from its README. This allows the system to compose language-appropriate issue headers and formatting for the published proposals.

Does this approach to publishing GitHub issues require the gh CLI?

Publishing GitHub issues does not strictly require the gh CLI, as it uses a deterministic authentication fallback. It attempts gh CLI first, then a token-based API call, and finally a draft-only output if no authentication succeeds.

How do I resolve the target repository for a GitHub issue without manual configuration?

Resolving the target repository for a GitHub issue is done automatically by extracting details from a specified owner/name or from the current git origin. This removes the need for manual repository configuration in your workflow.

Why use a JSON payload when publishing feature proposals to GitHub?

Using a JSON payload when publishing feature proposals provides machine-readable outputs containing the mode, issue URL, rendered body, and publish errors. This structured format enables reliable downstream automation and workflow integration.