Skip to main content
skill CX Codex

oma-market — Claude Code skill: what it does, how to install

oma-market runs community-signal research on customer pain, trends, and competitors, then saves a market brief for the requested topic.

MIT ★ 1,472 updated 2026-11-12

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Open on GitHub

What oma-market does

The skill routes a request through the last30days engine with oma market, classifies the research intent, and writes one Markdown brief to .agents/results/market/. It covers user complaints, category movement, competitor comparisons, and open-ended research on a person, company, or ticker. The --vs option starts the comparison flow.

The brief contains ranked evidence clusters and framework sections. Pain and trend work gets SWOT, competitor research adds Porter's 5F, and discovery adds PESTEL. Sources that need keys or cookies are skipped inside the engine, while keyless sources such as Reddit, HN, and GitHub still run. Python 3.12+ is required for engine resolution, so the workflow stops when that interpreter is unavailable. Raw artifacts go to .agents/results/market/raw/.

What it helps with

  • extract customer complaints from community posts
  • measure a trend across a --days window
  • compare competitors through community sentiment
  • research a company, person, or ticker

Example prompts for the agent

  • Research customer pain for this category with --intent pain and save the market brief.
  • Find trends across --days 30 and include the relevant framework sections.
  • Compare Product A with Product B using --vs Product B and assess their positioning.

How to install oma-market

1Plugin marketplace

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

This installs the whole oma plugin with all its skills

2Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-market -a claude-code

3Manually: put the files in place

~/.claude/skills/oma-market/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/oma-market/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about oma-market

How do I install oma-market in Claude Code?

Add the marketplace with /plugin marketplace add first-fluke/oh-my-agent, then install the skill with /plugin install oma@oh-my-agent.

What does oma-market do?

It runs market research through the last30days engine, gathers signals about customer pain, trends, and competitors, and saves a Markdown brief under .agents/results/market/.

What does oma-market require to run?

The workflow needs Python 3.12+ plus the oma market resolve and oma market run commands. Sources that require keys or cookies are skipped by the engine.

Source text

SKILL.md · MIT
---
name: oma-market
description: "Research customer pain points, trends, and competitors through the OMA market engine. Use for market discovery or voice-of-customer analysis."
---

# Market Research Agent - Community Signal Intelligence

## Scheduling

### Goal
Run the upstream `last30days` research engine (always the latest release, managed by oma) for community-signal research, then frame the result for the user's intent (pain / trend / competitor / discovery) with strategic frameworks and save one brief under `.agents/results/market/`.

### Intent signature
- User asks about pain points, user complaints, or voice-of-customer signals for a product or category.
- User asks what is trending, growing, or declining in a space this week or month.
- User asks how one product compares to another in community sentiment or positioning.
- User asks for discovery or exploratory market research on a topic, a person, a company, or a ticker.

### When to use
- Extracting real user pain points from community posts (Reddit with real upvotes and top comments, HN, X, Bluesky, GitHub Issues)
- Detecting trends in a category over a window (`--days 7|30|90|180`)
- Competitor sentiment analysis and SWOT / Porter's 5F positioning
- Open-ended discovery research (`--discover`), person mode, hiring signals (`--hiring-signals`), follow-up drills (`--drill`)

### When NOT to use
- General web research without market framing -> use oma-search directly
- Academic literature -> use oma-scholar
- Live dashboards or scheduled monitoring -> `oma schedule <action>` wrapping this skill

### Expected inputs
- Topic string; optional `--intent pain|trend|competitor|discovery` (else classified per `resources/intent-rules.md`)
- Optional window (`--days`), `--vs <entity>` (competitor), `--frameworks auto|none|swot,5f,pestel`
- Any native last30days flag (see `oma market run --help`) — passed through verbatim

### Expected outputs
- Single markdown brief at `.agents/results/market/{topic-slug}-{YYYYMMDD}.md`
- First line: the engine's badge (`🌐 last30days v{VERSION} · synced {date}`); body per the upstream OUTPUT CONTRACT; framework sections appended per intent; engine footer preserved
- Raw engine artifacts under `market.save_dir` (default `.agents/results/market/raw/`)

```yaml
outputs:
  - name: market-brief
    description: Single LAW-compliant markdown brief with framework sections
    artifact: ".agents/results/market/*.md"
    required: true
```

### Dependencies
- `oma market resolve` / `oma market run` — engine location, Python 3.12+ resolution, `--save-dir` default
- The upstream `SKILL.md` at the resolved engine root (`skillMd` in `oma market resolve --json`) — the authoritative research contract
- `resources/intent-rules.md`, `resources/frameworks/`, `resources/output-laws.md`, `resources/execution-protocol.md`

### Control-flow features
- `oma market detect-trap` gate before anything else (exit 2 = REFUSE, exit 4 = invalid)
- Engine is the skills-CLI install of `last30days`: `oma market resolve` reads installed skill dirs (a `market.path` / `LAST30DAYS_HOME` pin wins); `oma market update` installs it when missing and updates it otherwise
- Sources needing keys/cookies auto-skip inside the engine; keyless sources (Reddit, HN, GitHub, Polymarket, arXiv, Techmeme, Digg, web) always run
- Framework auto-toggle by intent (pain/trend → SWOT; competitor → SWOT + Porter's 5F; discovery → SWOT + PESTEL)

## Structural Flow

### Entry
1. Run `oma market detect-trap "<topic>"`. Exit 2 → surface the REFUSE reason and reframe suggestion, stop.
2. Run `oma market resolve --json`. `ok: false` → report `reason` (missing engine → ask the user, then `oma market update`; missing Python → the install hint) and stop. Never fall back to WebSearch-only synthesis and present it as market research.
3. Read the upstream contract at `engine.skillMd` **top to bottom**. It is long by design; do not skim. Treat `engine.root` as its `SKILL_DIR`.
4. Classify intent per `resources/intent-rules.md`; map to engine flags and framework set. Record the intent, flags, and frameworks with subject `market.route-selection` per `../_shared/runtime/route-selection.md` (explicit flag, `--vs`, or the keyword score that decided it).

### Scenes
1. **PREPARE**: detect-trap, resolve, read upstream SKILL.md, classify intent.
2. **UPSTREAM STEPS**: follow the upstream SKILL.md exactly — Step 0 (first-run setup wizard, consent-driven), intent parsing, Step 0.45 (its own query-quality preflight), Step 0.5 / 0.55 (handle, subreddit, hashtag resolution when WebSearch is available), Step 0.75 (query plan). Skip only its "Runtime Preflight" Python-hunt block: `oma market run` already resolved the interpreter.
3. **RUN**: wherever the upstream contract says `"${LAST30DAYS_PYTHON}" "${SKILL_DIR}/scripts/last30days.py" <args>`, run `oma market run <args>` with the **same arguments** (foreground, 5-minute timeout, `--emit=compact`). `--save-dir` is added automatically from `market.save_dir` unless you pass one.
4. **SYNTHESIZE**: produce the brief exactly as the upstream OUTPUT CONTRACT dictates (badge first line, Ranked Evidence Clusters, LAWs). Then append the framework sections selected for the intent, using only clusters present in the engine output as evidence (`resources/frameworks/`).
5. **FINALIZE**: run the self-check in `resources/output-laws.md`, write `.agents/results/market/{topic-slug}-{YYYYMMDD}.md`, preview the first 50 lines.

### Transitions
- `--vs <entity>` or "A vs B" phrasing → competitor intent → upstream COMPARISON flow (two passes + head-to-head as its contract specifies) → SWOT + Porter's 5F.
- Person / company / ticker topics → upstream person / hiring-signals / StockTwits handling applies unchanged.
- `engine.status: stale` → include the `note` in the report (research ran on the cached engine version).

### Failure and recovery
- detect-trap exit 2 → REFUSE; do not run the engine; `--force` only on explicit user reconfirmation.
- `oma market resolve` not ok → stop with the reason; no engine run.
- Engine non-zero exit → report stderr verbatim; do not synthesize from partial stdout unless the upstream contract says the emitted compact output is still valid.
- Upstream Python-version gate / setup wizard messages → relay to the user exactly as the upstream contract instructs.

### Exit
- Success: brief written with badge, clusters, frameworks, and engine footer; path reported.
- Partial: engine ran with skipped sources (footer lists them) — say so; never pad with invented evidence.

## Logical Operations

### Actions
| Action | SSL primitive | Evidence |
|--------|---------------|----------|
| detect-trap preflight | `VALIDATE` | Topic arg, trap pattern rules |
| Resolve engine + Python | `CALL_TOOL` | `oma market resolve --json` |
| Read upstream contract | `READ` | `engine.skillMd` |
| Classify intent | `SELECT` | `resources/intent-rules.md` |
| Upstream pre-research steps | `INFER` | Upstream SKILL.md Steps 0–0.75 |
| Run engine | `CALL_TOOL` | `oma market run <args>` |
| Synthesize + frameworks | `WRITE` | Upstream OUTPUT CONTRACT, `resources/frameworks/` |
| Self-check + write brief | `WRITE` | `resources/output-laws.md`, `.agents/results/market/` |

### Tools and instruments
- `oma market detect-trap <topic>` (preflight gate)
- `oma market resolve [--json]` (engine + Python resolution from installed skill dirs)
- `oma market update` (install the skill when missing, otherwise `bunx skills update last30days -g -y`)
- `oma market run <engine args…>` (passthrough to the resolved upstream engine’s Python entry point)

### Canonical command path
```bash
TOPIC="VS Code pain points"
oma market detect-trap "$TOPIC"
oma market resolve --json            # read .engine.skillMd, then follow it
# … upstream Steps 0 / 0.45 / 0.5 / 0.55 / 0.75 …
oma market run "$TOPIC" --plan "$QUERY_PLAN_FILE" --subreddits=vscode --emit=compact --save-suffix=v3
```

### Resource scope
| Scope | Resource target |
|-------|-----------------|
| `NETWORK` | Inside the engine only (its per-source fetchers); GitHub for the managed engine refresh |
| `LOCAL_FS` | installed skill dir such as `~/.agents/skills/last30days/` (engine), `~/.config/last30days/` (engine config, keys), `.agents/results/market/` (brief + raw) |
| `PROCESS` | `oma market` subcommands → the resolved upstream Python entry point |

### Preconditions
- Topic passes detect-trap.
- `oma market resolve` is ok (engine present; Python ≥ 3.12 found on PATH, via `uv`, or pinned with `market.python` / `LAST30DAYS_PYTHON`).

### Effects and side effects
- Writes the brief to `.agents/results/market/{topic-slug}-{YYYYMMDD}.md` and raw engine files to `market.save_dir`.
- First run: the upstream setup wizard may write `~/.config/last30days/.env` with user consent.
- If Python 3.12+ is absent, `oma market resolve` stops before the upstream setup wizard. Relay its install hint; after an authorized interpreter installation, retry resolution. Do not expect the skipped upstream Python preflight to install it.

## References
- Execution protocol: `resources/execution-protocol.md`
- Intent routing: `resources/intent-rules.md`
- Output contract: `resources/output-laws.md`
- Applicable framework: `resources/frameworks/swot.md`, `resources/frameworks/porters-5f.md`, or `resources/frameworks/pestel.md` (load only the selected framework)
- Validation: `resources/checklist.md`
- Recovery: `resources/error-playbook.md`
- Upstream engine instructions: read the resolved `engine.skillMd` path from `oma market resolve --json`; upstream scripts are managed engine files, not bundled skill resources.

© First Fluke · MIT · first-fluke/oh-my-agent

Similar skills

All skills for Marketing and content →
team-market-research sametcelikbicak team-market-research is a Claude Code skill that structures market, competitor, and user research. Guides niche validation, source hierarchy checks, and product risk evaluations. CX Codex +1 ★ 71repo stars pm-market-research Paweł Huryn pm-market-research is a Claude Code plugin for studying users and markets through feedback, segmentation, personas, and competitor analysis. Its commands cover feedback analysis, competitor comparisons, and user research. ★ 28,211repo stars market-researcher VoltAgent Community market-researcher analyzes market size, consumer behavior, and competitor positioning for business strategy and market entry. Useful when evaluating new niches or pricing models. CX Codex 881installs market-research c0x12c market-research is a Claude Code skill for researching markets, competitors, investors, and technology before testing a business idea or contacting a fund. CX Codex +1 ★ 111repo stars voc-research aiskillstore voc-research — a skill that extracts real customer quotes from forums, reviews, and social media to fuel copywriting, uncover pain points, and build messaging. Searches Reddit, ProductHunt, Google Reviews, TrustPilot, and more. CX Codex +1 1installs competitor-analysis phuryn The competitor-analysis skill researches direct competitors and compares their positioning, strengths, weaknesses, and pricing. Use it to prepare a competitive brief or find ways to differentiate a product. CX Codex +1 4,200installs

From the same set69

The whole set →
oma-architecture oma-architecture is a Claude Code skill that helps design module and service boundaries, compare alternatives, and document architecture decisions as ADRs. CX Codex +1 ★ 1,472repo stars oma-coordination The oma-coordination skill guides manual coordination across specialist agents on multi-domain projects. It covers task planning, progress checks, contract alignment, and a final QA review. CX Codex +1 ★ 1,472repo stars oma-hwp oma-hwp turns Korean HWP, HWPX and HWPML documents into Markdown via kordoc. Extracts text, tables, lists, images and footnotes. CX Codex +1 ★ 1,472repo stars oma-pdf oma-pdf converts PDF documents into structured Markdown while preserving tables, headings, and lists. Runs when preparing files for LLM context or RAG pipelines. CX Codex +1 ★ 1,472repo stars oma-video Builds videos through the OMA video CLI or works on an existing clip: pulling frames, cutting silence, assembling dubbed audio. CX Codex +1 ★ 1,472repo stars oma-skill-creator oma-skill-creator is a Claude Code skill that creates, formats, and validates OMA skills in SSL-lite format inside .agents/skills/. CX Codex +1 ★ 1,472repo stars oma-frontend oma-frontend is a Claude Code skill for building and editing frontend UI in React, Next.js, and TypeScript projects, including components, pages, styles, and client logic. CX Codex +1 ★ 1,472repo stars oma-backend oma-backend is a Claude Code skill for implementing server APIs, authentication, and application data access. It activates for endpoint, server-logic, and background-job tasks. CX Codex +1 ★ 1,472repo stars

Project sponsors

Companies that keep this analytics open