github-issue-filer

majiayu000's avatarfrom majiayu000

File AnyPod GitHub issues (bug or feature) with the official templates and publish them through the gh CLI.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026
[Developer Tools]

When & Why to Use This Skill

The GitHub Issue Filer skill streamlines project management by automating the creation of bug reports and feature requests for the AnyPod repository. By integrating with the GitHub CLI (gh) and enforcing official templates, it ensures that all technical submissions are consistently formatted, contain necessary metadata like environment logs and reproduction steps, and are published directly to the version control system without manual entry.

Use Cases

  • Bug Reporting: Automatically transform a user's technical error description and log snippets into a structured GitHub bug report following official repository standards.
  • Feature Requests: Capture and format new functionality ideas into detailed feature request templates, including problem statements and proposed solutions.
  • Workflow Automation: Use the gh CLI integration to publish issues directly from a conversation, reducing the friction between identifying an issue and documenting it for the development team.
  • Data Consistency: Ensure all required fields such as 'steps to reproduce', 'expected behavior', and 'environment' are collected and validated before submission.
namegithub-issue-filer
descriptionFile AnyPod GitHub issues (bug or feature) with the official templates and publish them through the gh CLI.

GitHub Issue Filer

What This Skill Delivers

Files bug reports and feature requests in thurstonsand/anypod using the repository’s issue templates.

Use this skill whenever someone needs to create a GitHub issuefor a bug or feature.

How to Use the Skill

1. Pick the template

  • Bug report → pass bug
  • Feature request → pass feature
  • Inspect the current fields anytime:
    ./.claude/skills/github-issue-filer/scripts/create_issue.py bug --describe

Command options

  • --summary: Replaces <summary> in the template title (e.g., [bug] <summary>).
  • --data-file: Provide a path to the JSON payload instead of piping it via STDIN.
  • --describe: Prints the field list (identifier, description, optional flag, type, options) so you can see which inputs are available.

2. Gather inputs

  • Capture a concise summary to replace <summary> in the template title (e.g., “downloads stall on restart”).
  • Required fields:
    • Bug: happened (what went wrong)
    • Feature: problem (why the change matters)
  • If the user did not provide information for the optional fields (logs, YAML, environment, sources, etc.), ask them if they want to include this info. If the user declines, move on—do not block.
  • Keep answers short, remove secrets, and paste raw text; the script will format it.
  • Need a reminder of available fields? Run create_issue.py bug|feature --describe for the relevant template.

3. Build the JSON payload

Create a JSON object whose keys match the template IDs.

Example bug payload:

{
  "happened": "testing out this template",
  "expected": "as expected",
  "steps": "1. start container\n2. call endpoint",
  "source": "X/Twitter",
  "version": "nightly",
  "env": "TrueNAS SCALE",
  "feed_yaml": "feeds:\n  myfeed:\n    url: https://...",
  "logs": "error lines here"
}

Example feature payload:

{
  "problem": "listeners can’t filter Patreon tiers",
  "solution": "allow tier filter per feed",
  "sources": ["Patreon"],
  "context": "original request in Discord #support"
}

If the conversation already contains these facts, extract them yourself instead of re-asking.

4. Run create_issue.py

Execute the helper with the template name, summary, and JSON payload via STDIN:

./.claude/skills/github-issue-filer/scripts/create_issue.py \
  bug \
  --summary "downloads stall on restart" <<'JSON'
{...payload...}
JSON

Feature example:

./.claude/skills/github-issue-filer/scripts/create_issue.py \
  feature \
  --summary "make Patreon feeds filter tiers" <<'JSON'
{...feature payload...}
JSON

5. Share the result

Return the printed URL (and, if helpful, the confirmation output).