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.