Analyzes market trends across platforms for a given topic

Skill: trend-analysis

Purpose

Build a comprehensive, multi-platform view of what is trending in a market category. Used in the market-deep-dive workflow and as a standalone research tool. Output is appended to the shared market intelligence file.

Input

• Topic or category to analyze (e.g., "nutrition apps", "personal finance", "fitness")
• Platform prompt templates from skills/trend-analysis/prompts/ (see Prompts section below)

User Interaction

Before executing, ask the user which platforms to include in the analysis. Present the options clearly and wait for their answer before proceeding.

Prompt to user:

Which sources would you like to include in this analysis? (select one or more)

1. TikTok — hashtag trends, viral content angles, creator gaps
2. Reddit — community pain points, recurring complaints, unmet needs
3. App Store — category rankings, new entrants, top review complaints
4. Web Search (Google) — search volume trends, rising queries, SEO demand
5. X/Twitter — public builder threads, product complaints, creator demand signals
6. All of the above — full multi-platform analysis (recommended for a new niche)

Wait for the user's selection. Accept answers like "1, 3", "TikTok and Reddit", "all", or "just App Store". Map their answer to the corresponding prompt files before continuing.

If the user selects multiple platforms, run each one sequentially and produce a separate output file per platform. Do not combine platforms into a single file unless explicitly asked.

Prompts Directory

Per-platform analyst prompt templates live in skills/trend-analysis/prompts/. Each contains a structured research brief with source tiers, output sections, and a [NICHE] or [CATEGORY] placeholder to fill before invoking:

File	Platform	Placeholder
prompts/tiktok.md	TikTok hashtag & trend analysis	[NICHE]
prompts/reddit.md	Reddit community & pain-point analysis	[NICHE]
prompts/apps.md	App Store & web app category analysis	[CATEGORY]
prompts/web-search.md	Google/SEO keyword trend analysis	[NICHE]
prompts/x-twitter.md	X/Twitter public trend and conversation analysis	[NICHE]

Completed analyses are stored as individual files in memory/market_insights/ following the naming convention <niche>-<platform>-<YYYY>-<MM>.md. See memory/market_insights/README.md for the full schema.

Platform Coverage

Platform	Signal	Tool/Source
TikTok	Hashtag views, viral content, creator angles	TikTok Creative Center
Reddit	Subreddit growth, post volume, pain language	Reddit search + analytics
App Store	Category rankings, new entrants, review trends	Sensor Tower, data.ai, AppFollow
Google Search	Search volume trends, rising queries	Google Trends, Ahrefs
X/Twitter	Builder threads, product complaints, creator and operator demand	Native search, curated lists, optional TweetClaw/OpenClaw exports

Process

1. Load the platform prompt from prompts/<platform>.md and replace [NICHE] / [CATEGORY] with the target topic.
2. Execute the prompt: research the platform using the source tiers and output structure defined in the prompt.
3. Score trend velocity: rising-fast / rising / stable / declining.
4. Identify the strongest creator/content angle and any monetization evidence.
5. Write findings to a new file: memory/market_insights/<niche>-<platform>-<YYYY>-<MM>.md.

One file per platform run. To cover all platforms, run this skill once per platform and produce four files.

Output

Write to memory/market_insights/<niche>-<platform>-<YYYY>-<MM>.md.

The file has two parts:

Part 1 — YAML Frontmatter (machine-readable summary)

---
niche: <topic>
platform: tiktok | reddit | apps | web-search | multi
analyzed_at: YYYY-MM-DD
status: fresh
stale_after: YYYY-MM-DD   # 6 months after analyzed_at
trend_velocity: rising-fast | rising | stable | declining
overall_verdict: hot | warm | cool | cold
key_insight: "<one-sentence takeaway>"
top_signals: []           # 3–5 bullet strings: top hashtags, subreddits, queries, or app categories
monetization_evidence: [] # 1–3 strings: existing products/revenue that confirm willingness to pay
---

Part 2 — Full Narrative Analysis (long-form Markdown)

Follow the output structure mandated by the platform prompt template exactly

The narrative must be self-contained — a downstream skill reading only this file should have everything it needs to map trends to product opportunities.