gitwtfhub

wtf is topic-feasibility-screener?

lzh-phd/topic-feasibility-screener — explained in plain English

Analysis updated 2026-05-18

446PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TL;DR

Topic Feasibility Screener is a Codex skill that scores candidate empirical research topics from your dataset for both theory and data feasibility, producing an HTML dashboard with supporting evidence files.

Mindmap

mindmap
  root((topic-feasibility-screener))
    What it does
      Profiles your dataset
      Brainstorms candidate topics
      Searches real literature
      Scores feasibility 0 to 100
    Tech stack
      Python
      Codex
      Stata
    Use cases
      Screen research topics
      Check theory and data feasibility
      Audit literature evidence
    Audience
      Thesis and paper researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a rough research idea and an existing CSV or Stata dataset into a ranked list of feasible topics.

REASON 2

Check whether a candidate topic has real literature support or just a promising regression result.

REASON 3

Review a self-audit file and literature diagnostics before trusting a topic's feasibility score.

What's in the stack?

PythonCodexStata

How it stacks up

lzh-phd/topic-feasibility-screenerfacebookresearch/pixiokarpathy/researchpooler
Stars446449460
LanguagePythonPythonPython
Last pushed2026-06-112023-09-01
MaintenanceMaintainedDormant
Setup difficultymoderatehardmoderate
Complexity3/54/52/5
Audienceresearcherresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a CSV or Stata dataset and Codex to invoke the skill, script arguments vary by dataset structure.

MIT license: use, modify, and redistribute freely, including commercially, as long as the copyright notice is kept.

Wtf does this do

Topic Feasibility Screener is a Codex skill that helps researchers figure out whether an empirical research idea is actually worth pursuing, starting from an existing CSV or Stata dataset. Instead of asking someone to invent a topic from scratch, it profiles the dataset, brainstorms a broad set of candidate topics from the usable variables, searches real literature for related work, runs a first pass regression to check the data signal, and packages everything into a visual HTML dashboard. The tool is aimed at early stage thesis and paper work in fields like accounting, finance, economics, management, corporate governance, ESG, audit, disclosure, and capital markets research. Its core idea is that a statistically significant result on its own does not make a topic publishable. A good topic needs both theory feasibility, meaning a clear question, related literature, a believable mechanism, and a real gap, and data feasibility, meaning usable variables, enough variation, and a workable sample size. A useful distinction the tool makes is between a topic with no real theoretical footing and one that sits in a genuine frontier gap, where no paper studies the exact relationship yet but nearby literature offers supporting evidence. It sorts the literature it finds into four categories: direct evidence, bridge evidence from related concepts, background evidence, and weak evidence, and treats bridge evidence as valuable rather than simply irrelevant when direct evidence is missing. Running the main script produces an HTML report plus a set of supporting files: score breakdowns, literature diagnostics, a variable profile, and a mandatory self audit file meant to be checked before trusting any of the results. All the major dashboard scores are shown on a 0 to 100 scale, covering empirical feasibility, theory support, theory gap, topic alignment, and an innovation gap score. The README is explicit that the tool's rankings are a screening aid, not proof of a publishable finding, and that final decisions on variables, research design, and literature positioning still require human academic judgment. It installs as a Codex skill and is released under the MIT license.

Yoink these prompts

Prompt 1
Run the topic-feasibility-screener research_topic_lab.py script on my dataset with a rough topic idea and default settings.
Prompt 2
Explain the difference between direct, bridge, background, and weak evidence in this tool's literature scoring.
Prompt 3
Walk me through installing topic-feasibility-screener into my Codex skills directory.
Prompt 4
Summarize what the feature_validation_checks.csv file is used for and why I should check it first.

Frequently asked questions

wtf is topic-feasibility-screener?

Topic Feasibility Screener is a Codex skill that scores candidate empirical research topics from your dataset for both theory and data feasibility, producing an HTML dashboard with supporting evidence files.

What language is topic-feasibility-screener written in?

Mainly Python. The stack also includes Python, Codex, Stata.

What license does topic-feasibility-screener use?

MIT license: use, modify, and redistribute freely, including commercially, as long as the copyright notice is kept.

How hard is topic-feasibility-screener to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is topic-feasibility-screener for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.