ask-good-questions

Structures technical questions and bug reports with reproducible minimal information for GitHub Discussions and issues.

96|8|Updated Aug 13, 2026
One-click install
npx skills add https://github.com/pingfanfan/hello-dsh --skill ask-good-questions-pingfanfan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ask-good-questions
Source: https://github.com/pingfanfan/hello-dsh/tree/main/examples/skills/ask-good-questions
Command: npx skills add https://github.com/pingfanfan/hello-dsh --skill ask-good-questions-pingfanfan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Technical questions posted in GitHub Discussions, issues, or team channels often lack the information maintainers need to act, leading to ignored threads and wasted back-and-forth. This Skill turns vague reports like "it doesn't work" into answerable questions with a complete, minimal information set. ## Core Features & Use Cases - Mandatory information checklist: Enforces version/environment details, minimal reproduction steps, expected vs. actual behavior, full untruncated error output, and a list of solutions already tried. - Title and pre-submission guidance: Provides a symptom-plus-condition title formula and a pre-flight checklist (read docs, search existing issues, test another environment, confirm it is a real bug). - Feature request framing: Guides writing proposals that state the underlying problem first, current workarounds, and honest beneficiary scope. - Use Case: Before opening an issue about skills not loading, use this Skill to produce a report with exact versions, a minimal repro in /tmp, the full error log with credentials redacted, and a searchable title. ## Quick Start Help me write a GitHub issue about my tool failing to load config files, following the ask-good-questions checklist.

Frequently Asked Questions about ask-good-questions

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

FAQPage Schema
How do I write a good bug report on GitHub?▼

A good bug report includes exact software and OS versions, minimal reproduction steps from a clean environment, expected versus actual behavior stated separately, and the complete untruncated error output in a code block. Also list what you already tried to eliminate obvious causes.

What information should a technical question include?▼

Include software version from --version output, operating system, runtime versions, installation method, a minimal reproduction case, full error text, and steps already attempted. Never write "latest version" since maintainers may be on a different release.

How do I create a minimal reproduction for a bug?▼

Start from a clean environment and remove everything unrelated to the problem until removing anything more stops the bug from appearing. The minimization process itself often reveals the root cause before you even submit the report.

Should I redact anything before posting error logs publicly?▼

Yes, redact API keys, tokens, passwords, full home directory paths, internal domains, IP addresses, and business data before posting. Treat any credential already posted as leaked and rotate it immediately.

Why do maintainers ignore some issues and questions?▼

Questions lacking versions, reproduction steps, or error details cannot be acted on, so maintainers skip them. A complete report with a symptom-plus-condition title signals the poster did their homework and gets prioritized.