gitwtfhub

wtf is market-research-skill?

naidx0/market-research-skill — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · pm founderLicense

TL;DR

A Claude Skill that researches a company's competitors from live web search and outputs a report plus a Mermaid roadmap.

Mindmap

mindmap
  root((Market Research Skill))
    What it does
      Competitor research
      Sourced report
      Mermaid roadmap
    Tech stack
      Python
      Claude Skills
      Mermaid diagrams
    Use cases
      Competitive analysis
      Feature comparison
      Structured data export
    Audience
      Founders
      Product managers

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

Generate a competitive landscape report for a company with sourced claims for every feature comparison.

REASON 2

Produce a visual Mermaid timeline showing where each competitor sits on a market maturity scale.

REASON 3

Get a structured JSON dataset of competitor research that can be reused or re-rendered.

REASON 4

Add competitive research capability to Claude Code as a reusable per-project or global skill.

What's in the stack?

PythonClaude SkillsMermaid

How it stacks up

naidx0/market-research-skill0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderate
Complexity2/54/5
Audiencepm foundergeneraldeveloper

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

Wtf does this do

market-research-skill is a Claude Skill, meaning a folder of instructions that teaches Claude how to carry out a specific task well, in this case researching a company's competitors and turning that research into a finished report. A user says something like research competitors for a named company and its product category, and Claude searches the web for three to five direct competitors in the same category, records their positioning and features, and requires a source link behind every claim it writes down. Anything a source does not clearly state is marked unknown rather than guessed at. The findings are saved into a structured data file, including where each competitor sits on a four stage maturity scale from MVP up through category defining. A bundled Python script then checks that data for completeness, such as making sure every company has at least one source and every listed feature has a value, and turns it into a markdown comparison table and a Mermaid timeline diagram showing each competitor's position. The final output is a folder containing a full written report with the table and diagram embedded, plus the standalone diagram, the standalone table, and the raw structured data file behind them, rather than just a chat reply. Before finishing, Claude is instructed to walk through a checklist confirming every competitor actually came from a real search result, every filled-in table cell can be traced back to a listed source, the validation script ran successfully, and the diagram embedded in the report matches the standalone diagram file exactly. Installing it is just cloning the repository into a Claude Code skills folder, either for one project or globally for every project. It needs web search enabled in the Claude environment and Python 3.8 or later on the system path, using only Python's standard library so no extra packages need installing. The project is licensed under the MIT license.

Yoink these prompts

Prompt 1
Research competitors for [my product] in the [category] market and build a comparison report.
Prompt 2
Explain how this skill decides whether a claim about a competitor is verified or marked unknown.
Prompt 3
Show me how the maturity stages from MVP to category-defining are assigned to each competitor.
Prompt 4
Help me install this skill globally so every Claude Code project can use it.

Frequently asked questions

wtf is market-research-skill?

A Claude Skill that researches a company's competitors from live web search and outputs a report plus a Mermaid roadmap.

What language is market-research-skill written in?

Mainly Python. The stack also includes Python, Claude Skills, Mermaid.

Who is market-research-skill for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

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