market-intelligence

name	Market Intelligence
description	Advanced trend spotting and keyword intent analysis system. Uses Agentic Research to replicate the "unfair advantage" of paid tools like Ahrefs and Google Trends.

📉 Market Intelligence (The "Unfair Advantage")

"Data is plentiful. Insight is scarce." v2.0 (2026-02-05): Architecture refactored from Python scripts to Agentic Workflows after critical QA failure.

This skill transforms your agent into a Strategic Data Broker. Instead of just "searching" for a topic, it analyzes the market dynamics behind it. It tells you not just what people are searching for, but why—and whether they have their wallets out.

⚠️ Architecture Note

This skill does NOT use Python scripts to generate intelligence. All intelligence is generated by the Agent (you) following the workflow instructions. Python files in this directory are for reference or utility purposes only.

🛑 Grounding Gate (MANDATORY — read before any validation or brief)

keyword_auditor.py SERP output is MOCKED. There is no live SERP feed in this skill. Do NOT present trend, intent, volume, or "real data" claims from your own reasoning — that is fabrication, not validation.

Any market / SERP / volume / intent claim MUST be grounded through the unified research engine, which returns a Research Receipt (Gemini-first → Perplexity → Tavily bedrock floor; $0 on failure):

python3 execution/research.py "<query>" --depth standard

Use --depth quick|standard|deep|max to scale effort (deep/max fan out via .agent/workflows/deep-research-swarm.workflow.js).

Source rule: Any number or claim NOT backed by a source URL in the Research Receipt must be explicitly labeled ESTIMATE. Do not claim "live SERP validation" or "real data" unless the engine actually sourced it. The "Ahrefs / Google Trends unfair advantage" framing is aspirational positioning, not a live data feed — honor it only with receipts.

🧠 The Capabilities

1. 🔥 Trend Hunting (The "Google Trends" Layer)

Replicates: Google Trends + Exploding Topics

• Capability: Identifies rising topics before they saturate.
• Method: Agent uses search_web to query Reddit, Twitter, and news sources.
• Command: Run /hunt-trends

2. 🎯 Intent Analysis (The "Ahrefs" Layer)

Replicates: Ahrefs Keyword Explorer

• Capability: Distinguishes between "Browsers" and "Buyers".
• Method: Agent uses linguistic analysis AND live SERP validation.
• Command: Run /seo-keyword-audit

3. 📊 Strategic Briefing (The "Agency Dossier" Layer)

Replicates: A $5,000 SEO agency report

• Capability: Generates a comprehensive keyword strategy brief with real data.
• Method: Agent performs Entity Understanding, Agentic Keyword Research, and sources all claims.
• Command: Run /generate-brief

---

🚀 How to Use This Skill

Phase 1: Hunt for Opportunity

Use this to find what to sell or write about.

• Command: Run /hunt-trends "[Niche]"
• Input: "AI Tools", "Fitness", "First Time Home Buyers".

Phase 2: Validate the Money

Use this to confirm people actually pay for it.

• Command: Run /seo-keyword-audit "[Keyword]"
• Input: "CalHFA Loan Requirements" (High Intent) vs "History of Mortgages" (Zero Intent).

Phase 3: Build the Strategy

Use this to get a full attack plan.

• Command: Run /generate-brief "[Niche]"
• Output: A sourced, data-backed Strategy Dossier.

📂 File Structure

• SKILL.md: This file.
• references/genius-patterns.md: The logic behind "Buyer Intent", "Entity Understanding", and "Data Grounding".
• keyword_auditor.py: (Reference only) Original linguistic analysis logic. Superseded by /seo-keyword-audit workflow.
• templates/brief_template.md: (Reference only) Original template structure.

Execution Prompts (structure-pure v2)

3 deterministic practitioner prompts — each carries an Output Contract, Output Skeleton, and Quality Gate. When a deliverable matches one, Read it and honor its contract instead of improvising the output shape.

• Keyword Intent Audit — [Niche/Entity] — skills/market_intelligence/references/prompts-v2/keyword-intent-audit.md
• Strategic IQ Brief: [Niche Name] — skills/market_intelligence/references/prompts-v2/strategic-iq-brief.md
• Trend Hunt Scan — [Niche/Seed Topic] — skills/market_intelligence/references/prompts-v2/trend-hunt-scan.md