map-your-market

Collects pain signals from Reddit, HN, GitHub Issues, G2, and Google Trends to build a positioning framework.

636|68|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Varnan-Tech/opendirectory --skill map-your-market
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-your-market
Source: https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market
Command: npx skills add https://github.com/Varnan-Tech/opendirectory --skill map-your-market

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Founders and marketers spend days manually reading Reddit threads, Hacker News posts, and G2 reviews to understand their market. This Skill automates that research sweep in minutes, returning verbatim customer pain quotes, an ICP profile, and a messaging framework grounded in real market language instead of invented copy.

Core Features & Use Cases

  • Multi-source pain collection: Searches Reddit, Hacker News (Algolia API), GitHub Issues, G2 category pages, and Google Trends direction, then scores every signal by source weight and recency.
  • Pain clustering and ICP profiling: Clusters the top 60 signals into 5-7 named pain themes and extracts ICP signals from subreddit distribution and post metadata.
  • Positioning framework output: Generates positioning angles, landing page headlines, and cold email subject lines using verbatim market language, saved to docs/market-maps/ as Markdown plus a JSON snapshot for quarterly velocity tracking.
  • Use Case: A founder building a developer observability tool provides competitors Datadog, Grafana, and New Relic. The skill detects relevant subreddits, collects 100+ pain signals, clusters them into themes like pricing and alert fatigue, and outputs a positioning doc with exact quotes from practitioners.

Quick Start

Ask your agent: "Map my market: I build developer observability tools. Competitors: Datadog, Grafana, New Relic."

Frequently Asked Questions about map-your-market

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

FAQPage Schema
How do I research my market and find customer pain points automatically?

Provide a product description, category keywords, or competitor names, and the skill searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for pain signals. It scores, clusters, and synthesizes them into a positioning framework with verbatim quotes in about 3 minutes.

How to find my ICP using Reddit and Hacker News data?

The skill extracts ICP signals from subreddit distribution and post metadata rather than just post content. It maps subreddits like r/devops or r/SaaS to practitioner roles and reports a confidence level based on signal volume and source diversity.

Does map-your-market require API keys?

No API keys are required. Reddit, HN Algolia, G2 scraping, and trends all work without authentication. An optional GITHUB_TOKEN raises the GitHub Issues rate limit from 60 to 5000 requests per hour.

Can I run the data collection script without an AI agent?

Yes, scripts/fetch.py runs standalone with python3, accepting a category, optional --competitors and --context flags, and writing raw signals to a JSON file. You can then bring that file to any AI for analysis.

What happens when a market category has too little data?

If fewer than 10 pain signals are found, the skill stops and reports that the market may be too niche, suggesting broader keywords or adding competitor names. It does not fabricate pain points or write an output file with invented data.