SKILL.md
5.6 KB
Skill: trend-scout-global
Domain: Global short-video and social trend monitoring (TikTok / Instagram Reels / YouTube Shorts / X / Pinterest / CapCut Templates) Version: 1.0.0 Date: 2026-04-13
Objective
Discover, validate, clean, structure, grade, and report global social-media trend signals across TikTok, Instagram Reels, YouTube Shorts, X, Pinterest, and CapCut Templates.
Output Schema
Every trend record MUST conform to the following schema:
{
"trend_id": "string",
"platform": "TikTok|Instagram|YouTube|X|Pinterest|UNKNOWN",
"region": "US|JP|BR|UK|DE|IN|PH|AU|UNKNOWN",
"content_type": "hashtag|audio|video|effect",
"name": "#canonical hashtag",
"rank": 1,
"views_or_posts": 0,
"growth_7d": 0.0,
"related_hashtags": ["string"],
"source_url": "https://...",
"crawl_time": "2026-04-13T02:40:00Z"
}
All timestamps must be ISO-8601 UTC ending with Z.
Cross-Platform Information Source Understanding
- Platform Detection: Identify the originating platform from
source_url, explicitplatformfields, or language hints.tiktok.com/ads.tiktok.com/日本版TikTok→ TikTokinstagram.com/reels→ Instagramyoutube.com/youtube_shorts/YouTube Shorts→ YouTubex.com/twitter.com→ Xpinterest.com→ Pinterestcapcuttemplate.io/capcutonline.com→ CapCut- Unrecognized aggregator → UNKNOWN
- Region Mapping: Map region hints to ISO-style codes.
Japan/日本/ja-JP→ JPBrasil/Brazil→ BRUK/United Kingdom→ UKDE/Germany→ DEIN/India→ INPH/Philippines→ PHAU/Australia→ AUUS/United States→ US- Missing or ambiguous → UNKNOWN
- Content Type: Derive from context.
- Hashtag entries →
hashtag - Video/Shorts entries →
video - Pinterest boards / CapCut templates / effects →
effect - Audio/BGM trends →
audio
- Hashtag entries →
Trend Recognition & Theme Extraction
- Canonical Name Generation: Convert raw titles to canonical English hashtags.
- Spanish
Amor de Vampiro→#vampire love Second Chance Romance→#second chanceMafia Romance Aesthetic→#mafia romanceWerewolf Mate→#werewolf mateContract Marriage→#contract marriageStrong Female Lead→#strong female leadVertical Drama→#vertical dramaInteractive Story→#interactive story
- Spanish
- IP-Style Themes: Detect associated themes:
billionaire romance,werewolf mate,mafia romance,strong female lead,revenge,vampire love,contract marriage,second chance,interactive story,vertical drama. - Related Hashtags: Extract without duplication. Output
[](empty array) when none exist. Never outputnullforrelated_hashtags.
Data Cleaning & Structuring
- Numeric Parsing:
- Convert strings like
"1.3B"→1300000000,"24.5B"→24563880969,"45.4B"→45416623921. - Convert percentage strings
"+24%"→0.24,"+298%"→2.98,"+106%"→1.06forgrowth_7d. - If
growthis missing, defaultgrowth_7dto0or1depending on context (stable trend default).
- Convert strings like
- Required Fields: Ensure
trend_id,platform,region,content_type,name,rank,views_or_posts,growth_7d,related_hashtags,source_url,crawl_timeare always present. - Rank Assignment: Assign sensible integer
rankvalues (1+). When raw rank is missing, infer from order or context. - Crawl Time: Use ISO-8601 UTC. For batch processing, use
2026-04-13T02:40:00Zunless a fresher timestamp is explicitly available in the raw data.
Trend Grading & Forecasting
- Conflict Resolution: When multiple raw entries describe the same trend:
- Prefer the fresher crawl_time (e.g., YouTube 2026-04-13 over TikTok 2026-04-10).
- If timestamps are equal, prefer the higher volume source.
- Document the resolution in
conflict_resolutionornotefields.
- Growth Interpretation:
growth_7d > 2.0or very high percentage → label as breakout.growth_7d < 0or negative percentage → label as plateau or declining.- Stable values (near 0–0.5) → normal trend.
- Volume vs. Growth: Do not average conflicting
growth_7dvalues blindly. Choose a canonical source and stick to its metrics.
Report Output Specification
- Produce structured output as a JSON array or markdown table.
- Include per-platform summaries, top themes, regional highlights, and actionable takeaways.
- Preserve all
source_urlvalues for traceability. - Ensure generated URLs are valid and reachable in principle.
Exception Handling & Source Verification
- Low-Confidence Sources: Flag unverified accounts, unknown aggregators, or vague engagement data with
confidence: "low". - Stale Data Warning: If raw data is older than 7 days relative to
crawl_time, setstale_warning: true. Do not forecast stale growth as current breakout. - Missing Metrics Fallback:
- Missing
views_or_posts→ infer from seed context or output0. - Missing
growth_7d→ default to0or1(stable). - Missing
rank→ infer from context or assign sequentially. - Missing
related_hashtags→[].
- Missing
- Graceful Defaults:
- Unknown platform →
"UNKNOWN". - Unknown region →
"UNKNOWN". - Unparseable engagement (e.g.,
"high"without numbers) →views_or_posts: 0,growth_7d: 0, withconfidence: "low".
- Unknown platform →
- No Hallucination: Never invent metrics, URLs, or trend data when input is incomplete or conflicting.