agentleFS
nirholasnirholas/XActions/skills/discovery-explore/SKILL.md

discovery-explore

Skill648 starsChanged 9 months agoApache-2.0View on GitHub

Explores X/Twitter trending topics, searches for content, and discovers new accounts. Includes trending topic monitoring, keyword search, explore page scraping, and topic discovery. Use when users want to explore trends, search for content, or discover new accounts and topics on X.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use scripts/scrapeSearch.js or x_search_tweets for niche keywords

    line 76
  2. Very specific:

    Use src/viralTweetDetector.js on popular accounts in your niche

    line 78

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Discovery & Explore

Browser console scripts and MCP tools for exploring trends, searching content, and discovering accounts on X/Twitter.

Script Selection

GoalFileNavigate to
Monitor trending topicssrc/trendingTopicMonitor.jsx.com/explore/tabs/trending
Search tweetsscripts/scrapeSearch.jsSearch results page
Scrape hashtagscripts/scrapeHashtag.jsx.com/hashtag/TAG
Find viral tweetssrc/viralTweetDetector.jsAny profile
Keyword monitoringsrc/keywordMonitor.jsAny page
Scrape explore pagesrc/exploreScraper.jsx.com/explore

MCP Tools

ToolDescription
x_get_trendsCurrent trending topics
x_get_exploreExplore page content
x_search_tweetsFull-text tweet search

Trending Topic Monitor

File: src/trendingTopicMonitor.js

Real-time trending topic scraper with niche classification.

Controls

  • XActions.scan() -- Scrape current trends
  • XActions.track() -- Log trend snapshot with timestamp
  • XActions.history() -- Show all tracked snapshots
  • XActions.forNiche(keyword) -- Filter trends by niche keyword
  • XActions.export() -- Download trend data as JSON

Features

  • Categorizes trends by niche (tech, politics, entertainment, sports, crypto, etc.)
  • Tracks trend velocity (rising/falling)
  • Identifies trending hashtags vs organic trends
  • Alerts on niche-relevant trends

Keyword Monitor

File: src/keywordMonitor.js

Monitors X for mentions of specific keywords with sentiment classification.

Controls

  • XActions.setKeywords(['keyword1', 'keyword2']) -- Configure keywords
  • XActions.scan() -- Run one search cycle
  • XActions.autoScan(intervalMs) -- Continuous monitoring
  • XActions.stop() -- Stop auto-scanning
  • XActions.report() -- Show summary with sentiment breakdown
  • XActions.export() -- Download results as JSON

Strategy Guide

Trend-jacking workflow

  1. Run src/trendingTopicMonitor.js -> XActions.forNiche('your_niche')
  2. Identify relevant trends with momentum
  3. Craft timely content using src/threadComposer.js or src/contentRepurposer.js
  4. Post within the first 2 hours of trend emergence for maximum visibility
  5. Track performance with src/tweetPerformance.js

Content ideation from search

  1. Use scripts/scrapeSearch.js or x_search_tweets for niche keywords
  2. Analyze top results for content gaps
  3. Use src/viralTweetDetector.js on popular accounts in your niche
  4. Repurpose successful formats with src/contentRepurposer.js

Building a discovery routine

  1. Daily: src/trendingTopicMonitor.js -> XActions.track() for trend log
  2. Weekly: Review XActions.history() for recurring themes
  3. Set src/keywordMonitor.js for brand/topic monitoring

Notes

  • Explore page content varies by region and account history
  • Trends refresh every ~15 minutes on X
  • Keyword monitor uses X search (subject to standard rate limits)
  • Trending data is publicly accessible (no auth needed for viewing)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.