oma-market

Extracts pain points, trends, and competitor signals from community sources into markdown briefs.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill oma-market-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-market
Source: https://github.com/javiruu/viru-air/tree/main/.agents/skills/oma-market
Command: npx skills add https://github.com/javiruu/viru-air --skill oma-market-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manual market research across Reddit, Hacker News, Bluesky, Mastodon, and GitHub Issues is slow and unstructured. This Skill automates community signal harvesting, scoring, clustering, and strategic framework synthesis into a single citation-backed markdown brief. ## Core Features & Use Cases - Intent-Routed Research: Classifies queries into pain, trend, competitor, or discovery intents, each with tailored operator packs, scoring weights, and output templates. - Deterministic CLI Pipeline: Runs detect-trap preflight, parallel harvest, scoring, RRF fusion, and entity-overlap clustering through oma market subcommands with JSON-only stdout per stage. - Strategic Frameworks: Auto-applies SWOT, Porter's 5 Forces, and PESTEL analyst prompts that the host LLM fills from the cluster bank with cited sources. - Use Case: Ask "What are VS Code pain points this month?" and receive a LAW-compliant brief with clustered complaints, inline citations, and a SWOT analysis saved to .agents/results/market/. ## Quick Start Ask the agent to research pain points for a product or category, for example: run oma-market on "Cursor vs Windsurf" with competitor intent to get a cited comparison brief.

Frequently Asked Questions about oma-market

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

FAQPage Schema
How do I extract user pain points from Reddit and Hacker News?▼

Run the pipeline with pain intent: harvest with the pain operator pack, then score, fuse, cluster, and render. The skill queries Reddit, HN, Bluesky, Mastodon, and GitHub Issues, clusters complaints by entity overlap, and emits a cited markdown brief.

How do I compare two competitors using community sentiment?▼

Use competitor intent with the --vs flag, for example "Cursor vs Windsurf". The harvest stage fans out one query per entity, clusters results independently, and renders a COMPARISON template with Quick Verdict, Head-to-Head table, and SWOT sections.

What sources does this market research skill support?▼

Keyless sources include Reddit, Hacker News, Bluesky, Mastodon, GitHub Issues, and grounding. Paid sources such as X, TikTok, Instagram, YouTube, and Perplexity are auto-skipped with an info message when their environment API keys are absent.

Why does the harvest step fail with all sources blocked?▼

Exit code 2 means every configured source returned rate limits or auth failures. Check paid-source env keys, widen the window to 90d, or restrict to a known-working source like --sources reddit before retrying.

What are the limitations of this market research skill?▼

It is one-shot only: no delta tracking, trend velocity over time, live dashboards, or scheduled monitoring. Broad or personal-advice topics are refused at the detect-trap gate, and trust registry data is read-only.