ginee-file-bug

Draft bug reports from templates and create labeled GitHub issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kostiantyn-matsebora/ginee --skill ginee-file-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ginee-file-bug
Source: https://github.com/kostiantyn-matsebora/ginee/tree/main/core/skills/ginee-file-bug
Command: npx skills add https://github.com/kostiantyn-matsebora/ginee --skill ginee-file-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of filing a bug report against your primary GitHub repository using the ginee framework's GitHub-integration workflow.

Core Features & Use Cases

  • Draft bug reports from the template at core/templates/issues/bug-report.md and populate it with project context.
  • Resolve the target repository from local framework configuration (local/framework.config.yaml § github.repo) or by inspecting git remotes (git remote get-url origin, stripping the trailing .git).
  • Self-lint the draft against mandatory checks and audience guidelines, surfacing issues and suggested restructures before publishing.
  • Surface the draft for human approval and, upon approval, create a labeled GitHub issue via gh issue create, MCP, or HTTPS+token.

Quick Start

Approve the drafted bug report to create a labeled GitHub issue in the target repository.

Frequently Asked Questions about ginee-file-bug

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

FAQPage Schema
How do I automate bug report filing on GitHub?

Automate bug report filing on GitHub by drafting an issue from a template, resolving the target repository from local configuration or git remotes, and creating a labeled issue upon approval. The workflow loads a bug-report template, populates it with project context, and self-lints against mandatory checks before publishing.

How does a bug report template get populated with project context?

A bug report template gets populated with project context by loading the file at core/templates/issues/bug-report.md. The workflow extracts repository details from local/framework.config.yaml or git remote get-url origin, then drafts the issue content for human review before submission.

Can I use this workflow without a framework.config.yaml file?

Yes, you can use this workflow without a framework.config.yaml file. The system resolves the target GitHub repository by inspecting git remote get-url origin and stripping the trailing .git suffix if the local configuration file is missing or lacks the github.repo setting.

What is the best way to ensure a drafted GitHub issue passes mandatory checks?

The best way to ensure a drafted GitHub issue passes mandatory checks is to use the workflow's self-linting step, which validates the bug report against audience guidelines and surfaces suggested restructures before creating the issue via gh issue create, MCP, or HTTPS+token.

Does this bug filing workflow require manual approval before creating a GitHub issue?

Yes, this bug filing workflow requires manual approval before creating a GitHub issue. It surfaces the drafted bug report for human review, and only upon approval does it execute issue creation with the appropriate labels in the target repository.

What are the limitations of automating bug filing through a GitHub integration workflow?

Limitations of automating bug filing through a GitHub integration workflow include a mandatory human approval gate before issue creation, reliance on resolving the target repository strictly from local/framework.config.yaml or git remotes, and dependency on a specific bug-report template structure for self-linting to pass.