plain-bug

Collect bug details and create a GitHub issue via gh CLI.

1.0k|27|Updated Mar 22, 2023
One-click install
npx skills add https://github.com/dropseed/plain --skill plain-bug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plain-bug
Source: https://github.com/dropseed/plain/tree/main/plain/plain/agents/.claude/skills/plain-bug
Command: npx skills add https://github.com/dropseed/plain --skill plain-bug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Submitting bug reports for the Plain framework can be tedious and error-prone. This skill guides users to collect essential details and automatically creates a GitHub issue, ensuring consistent reporting.

Core Features & Use Cases

  • Collects bug details: title, description, reproduction steps, actual error, and potential root cause to help maintainers triage effectively.
  • Gathers environment info: Plain version, Python version, and OS to reproduce issues accurately.
  • Confirms with user before submission to prevent accidental reports.
  • Creates a GitHub issue via gh CLI with a structured, shareable body suitable for issue triage and tracking.

Quick Start

Describe the bug details and approve the issue creation to submit a GitHub issue.

Frequently Asked Questions about plain-bug

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

FAQPage Schema
How do I report a bug in the Plain framework to GitHub?

To report a bug in the Plain framework, you provide the title, description, reproduction steps, and environment details. The tool gathers this information interactively and creates a structured GitHub issue using the gh CLI.

What details do I need to submit a GitHub issue for a Python framework bug?

Submitting a GitHub issue requires the bug title, description, reproduction steps, actual error output, and environment data. Environment data includes the Plain version, Python version, and operating system to help maintainers reproduce the issue accurately.

Does the bug reporting process ask for confirmation before creating a GitHub issue?

Yes, the bug reporting process asks for user confirmation before submitting the GitHub issue. This step prevents accidental reports by allowing you to review the gathered title, description, and environment details before the tool creates the issue.

How does automated bug report generation work with the GitHub CLI?

Automated bug report generation works by interactively collecting bug details and environment information, then formatting them into a structured body. It uses the GitHub CLI to directly create and submit the formatted issue to the repository for tracking.

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

Yes, you need the GitHub CLI installed to automate issue creation. The tool relies on the gh CLI to authenticate and submit the structured bug report directly to the Plain framework's GitHub repository.

Can I include a potential root cause when creating a GitHub bug report?

Yes, you can include a potential root cause when creating a GitHub bug report. The tool captures this alongside the title, description, reproduction steps, and error output to help maintainers triage the issue effectively.