How do I install the X Trends skill?

Run npx skillmds@latest add guillaumemeyer/x-trends in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is X Trends safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Trends?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X Trends free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X Trends?

guillaumemeyer (@guillaumemeyer) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Trends

Name: X Trends
Author: guillaumemeyer

X API v2 trends source (PRD §4.1, §6.8). Calls GET /2/trends/by/woeid (default WOEID 1 = worldwide) with Bearer auth from X_API_KEY. Skips gracefully when the key is absent. Capped at 20 trends per run; hashtag-only entries are filtered out.

guillaumemeyer Updated Sep 17, 2026

Product & Planning

Install

Press C to copy

$ npx skillmds@latest add guillaumemeyer/x-trends

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

Download SKILL.md

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/guillaumemeyer/x-trends.svg)](https://skillmd.com/skills/guillaumemeyer/x-trends)

Trust & safety

Audits pending

Not yet audited · commit 8bcc412

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

X Trends (X API v2)

How to run

If X_API_KEY is missing → {ok: false, skipped: true, error: "X_API_KEY not configured"} — the detection stage records the gap.
GET https://api.x.com/2/trends/by/woeid/{woeid}?expansions=geo with Authorization: Bearer $X_API_KEY, 15s timeout.
Take data[0].trends, drop entries whose name starts with #, cap at 20.

Signal shape (zod `SignalSchema`)

source: "x_trends"
source_ref: stable dedup key from source+title
title: trend name
volume: tweet_volume (if present)
detected_at: now (ISO)

Non-200 → {ok: false, error}; do not retry more than once.

guillaumemeyer/trendy/tree/main/skills/trendy/x-trends commit 8bcc41206f

Frequently asked questions

npx skillmds@latest add guillaumemeyer/x-trends