Good Question: a skill for sharpening research questions
Good Question
A skill that turns a vague interest, a literature gap or a proposal draft into a testable research question with a first-step plan
- 310 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill consists of instructions and reference cards; it runs nothing and connects to nothing by itself
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/good-questionDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill consists of instructions and reference cards; it runs nothing and connects to nothing by itself
This is third-party code. Review the repository files before installing.
What it does
Good Question guides a researcher from an idea to a testable question. First the skill works out what you came with: a vague interest, a literature gap, a ready idea, a grant proposal or a stalled project. Then it picks a role: mentor, reviewer, collaborator or funder. The output is one or more question cards. Besides the question itself, a card holds competing explanations and falsification conditions. It also has a two-week pilot and the strongest reviewer objection. The skill filters candidates by seven criteria, including significance, falsifiability and feasibility. If the question depends on recent work in the field, the skill first builds a short brief from public sources and separates what is confirmed from what is inferred. Extra modes audit the sources for a claimed gap and review a proposal from a reviewer's seat.
Who it is for. For graduate students, researchers and grant writers working in Claude Code or Codex who want to test an idea before starting work.
Good fit when
- You have only a field of interest and need several comparable questions from it
- You found a literature gap and want to know whether it is worth the work
- You are writing a grant proposal and want to see in advance where a reviewer would take it apart
- A project is stuck and the question needs reframing through boundaries and failure signals
- Before choosing a topic you need a public-source brief that separates facts from assumptions
Not a fit when
- You need a ready encyclopedic overview of a field: the skill does not replace domain knowledge and does not produce consensus without sources
- You need the text of a paper or proposal: the skill frames and tests the question but does not write the document
- You need to process data or run an experiment
- The question is already framed and approved and only the work remains
Example request
Use good-question: I want to study how drought affects floodplain forests; help me frame a testable question for a grant proposal.Limitations
The skill relies on the context you provide: field, time limits and goal (paper, thesis, grant, pilot). For recent topics it needs the agent to have search or source-reading tools; without them the field brief will be incomplete. It does not invent consensus and does not read an empty search result as proof that nobody did the work, and for a weak question it advises rewriting or shelving.
The documentation is bilingual, Chinese and English. If you write in Chinese, the reply comes in Chinese unless you ask otherwise. Russian prompts work too, but there is no separate Russian documentation.
How to disable. Delete the skill directory: ~/.claude/skills/good-question for Claude Code or ~/.codex/skills/good-question for Codex.
FAQ
How do I install Good Question in Claude Code?
Run git clone https://github.com/Rimagination/good-question.git ~/.claude/skills/good-question. No separate install or keys are needed: Claude Code picks the skill up from the folder. For other agents use SKILL.md as the main workflow and the references folder as a handbook.
What does a good question card contain?
A working title, the question, why it matters, the challenged assumption, competing explanations, the deciding experiment, falsification conditions, a two-week pilot, the strongest reviewer objection and the next action.
Where does the skill's method come from?
From publications on choosing research problems and strong inference: authors such as Alon, Platt and Hamming, the Heilmeier catechism for proposals, and Alvesson and Sandberg on problematization. Each source has its own card in the references folder.
How is Good Question different from deep-research skills?
Skills like Deep Research Skill gather sources and write a report on a topic. Good Question works on the question itself: it tests significance, falsifiability and feasibility and proposes a reframing.
In which language does the Good Question skill answer?
If you write in Chinese, the reply comes in Chinese unless you ask otherwise. The project documentation is bilingual, Chinese and English, with no Russian version, but the skill accepts a Russian prompt.
Discussion
No questions or reviews yet.
Related
Skillsget-job.skill (实习.skill)
get-job.skill
A skill that prepares a job search: it researches the role, rewrites your resume and drills you on every bullet
An analytical skill that tests whether users will find value in a product idea: scenario, conditions, timing and delivery, with solidity ratings
A job-hunt skill bundle: JD decoding, template resumes, behavioral interview prep, offer comparison and negotiation
grill-me: plan interview skill
grill-me
A Claude Code skill: the agent asks one multiple-choice question at a time until every branch of a plan or design is resolved
A skill set for resumes and job search: tailoring to a vacancy, ATS pass-through checks, cover letters and interview preparation
Qiushi Skill
求是 Skill
A set of methodology skills: investigate the facts first, find the main contradiction, validate in practice and finish the job
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| Good Question: a skill for sharpening research questions (this entry) | no | 310 | |
| Deep Research | no | 1,201 | gathers sources and writes a report on a topic, leaving the question itself as is |
| Scientific Agent Skills | no | 55,262 | a large set of skills for computational science tasks, with no work on framing the question |
README in short
The skill works in nine steps and relies on method cards, worked examples and evaluation case sets. Separate playbooks cover five fields, from ecology to biomedicine.
README badge
Original SKILL.md
--- name: good-question description: Use when a researcher is choosing, framing, refining, or stress-testing a research question, hypothesis, thesis topic, project idea, grant direction, paper angle, or stalled research direction. --- # Good Question Help a researcher turn a vague interest, literature gap, rough idea, failed project, or proposal draft into a strong scientific question. Do not merely list ideas; shape questions until they are important, tractable, falsifiable, and easy to defend to a skeptical colleague. ## Operating Principles - Prefer one sharp question over many decorative ideas. - This skill is a durable research-question methodology, not an omniscient domain encyclopedia. - Treat novelty as insufficient unless the question also matters. - Separate a topic, a problem, a hypothesis, and a project plan. - Make hidden assumptions explicit before proposing methods. - Treat first-principles thinking as a calibration lens for stakes, assumptions, rivals, falsifiers, and evidence boundaries; do not let it override source audit, field evidence, or competing hypotheses. - Ask at most one short clarifying question if the field, constraint, or existing idea is missing; otherwise proceed with stated assumptions. - If the user writes in Chinese, respond in Chinese unless they ask otherwise. - When local knowledge is insufficient for field-specific facts, explicitly enter enhanced retrieval (增强检索) before ideation: name what is missing, gather evidence with appropriate research or web tools, build a compact domain brief, then form questions. - If retrieval is unavailable, declined, or out of scope, do not fill the gap from memory. Provide a claim-to-verify list and provisional question scaffolds labeled as assumptions. - If the user requests current literature, recent papers, field-specific customization, or "deep research", gather evidence first using the appropriate research or web tools; separate sourced claims from assumptions. - Never turn "I do not know of work on X" into "nobody has studied X." Mark field claims as source-backed, inference, or unknown. - Do not attach citations as decoration. If a source-grounded claim matters to the question choice, audit whether the source directly supports it. - Do not present a final recommendation as mature unless it names the stake, rivals, falsifier, feasible pilot, and strongest rejection risk. ## Working Modes Infer the mode from the user request, or use the named mode if the user asks for one. | Mode | Use when | Behavior | |---|---|---| | Mentor | The user is early, uncertain, or writing a thesis/opening topic | Ask at most one clarifying question, then help them compare options without shame | | Reviewer | The user asks to stress-test, criticize, or find weaknesses | Lead with the strongest rejection risks and repair paths | | Collaborator | The user wants to act soon or has data/resources ready | Convert the best question into a two-week pilot and decision gate | | Grant | The user is writing a proposal, fund, or pitch | Emphasize audience, milestones, risk, success criteria, and kill criteria | ## Boundary With good-story Use `good-question` to decide what should be asked, tested, falsified, or killed. Use `good-story`, when it is available, to decide how existing evidence, figures, drafts, abstracts, or results should be organized into an honest scientific narrative. This boundary is a routing preference, not a capability reduction. If `good-story` is not available, `good-question` may still handle story-adjacent requests such as paper angles, proposal pitches, significance framing, abstract direction, or high-impact positioning. In that fallback mode, keep the answer question-first: clarify the claim, stake, evidence, assumptions, falsifier, reviewer risk, and next test. Label full narrative, figure-order, or prose-craft advice as provisional rather than pretending this skill is a complete writing-story framework. For ambiguous requests: