CLI tool
mvanhorn/last30days-skill avatar
mvanhorn/last30days-skill

last30days-skill: An Agent Skill That Searches Social Platforms Instead of Google

AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary.

62,082 stars5,415 forksPythonMIT

At a glance

What is it?
last30days-skill is an AI agent skill that queries Reddit, X, YouTube, HN, Polymarket, and more in parallel, scores results by engagement, and synthesizes a 30-day brief. The core trade-off: it replaces editorial ranking with social proof, but setup and API keys vary by source.
Who is it for?
Adopt last30days-skill if you are an AI agent user who needs a quick, engagement-ranked brief on a person, company, or topic, especially before meetings or product decisions. Do not adopt it if you require strict source control or if you cannot manage per-platform API keys and browser sessions for X, YouTube, and TikTok.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What It Solves and Who It Is For

The target user is someone who already runs an AI agent host like Claude Code, Codex, Cursor, or Copilot. The skill is distributed as an Agent Skills package, which means it slots into an existing agent workflow rather than standing alone. If you do not use an AI agent, this project has little direct value; you would be better off visiting each source manually. The README claims that no single AI has access to all these platforms natively, which is why the skill exists: it bridges walled gardens by letting you bring your own API keys and browser sessions.

How the Search and Synthesis Pipeline Works

The pipeline is orchestrated by a skill specification file, SKILL.md, which the README calls the source of truth for command and setup behavior. The actual data flow is not fully documented in the README, but the source list implies a modular design: each source is a connector that either works out of the box or requires a local CLI tool or API key. For example, Digg auto-enables when `digg-pp-cli` is on PATH, and arXiv, Techmeme, and Xiaohongshu have similar activation conditions. This suggests the skill detects available tools and keys at runtime, then includes only the sources it can access. The synthesis step likely runs after all source queries return, but the README does not specify the exact prompt or scoring algorithm.

Installation and First-Run Setup

The command syntax is a slash command: `/last30days Peter Steinberger` is the given example. The README also mentions a `--search xhs` flag for Xiaohongshu, which requires a logged-in x-mcp browser plugin or a local `xiaohongshu-mcp` service. This is the only explicit flag mentioned. The setup wizard and the SKILL.md file are the places to look for the full command options, but the README does not enumerate them. If you are not using a supported agent host, the README points to an Install section with more options, including claude.ai web and OpenClaw, but those details are truncated.

Source Coverage and Engagement Scoring

The scoring is the differentiator. The README states that the synthesis "ranks by what real people actually engaged with. Social relevancy, not SEO relevancy." This means a TikTok with 3.6M views outweighs a press release, and a Reddit thread with 1,500 upvotes is stronger than an unread blog post. This is a deliberate design choice, but it has a downside: engagement does not equal accuracy. A viral but false claim on X would rank high. The README acknowledges this implicitly by calling it "the unfiltered take," but it does not include any fact-checking layer. The skill is designed for speed and signal, not for verification.

Genuine Limitations and Failure Modes

There is also a platform coverage gap. The README mentions Truth Social and other niche sources are "in the engine," but they are not in the source table. That suggests the skill is still evolving. The README also says the synthesis is done by an "AI agent judge," but it does not specify which model or how it handles conflicting sources. The example output for Peter Steinberger includes specific claims like "23 PRs at 85% merge rate" and "r/ClaudeCode hit 569 upvotes," but the README does not show how the judge verified those numbers. If you need a defensible, cited brief for a legal or compliance context, this skill is the wrong tool because it prioritizes engagement over provenance.

Alternatives and the Difference in Approach

The key difference is the scoring model. Perplexity and Google rank by relevance to your query, often influenced by SEO. last30days-skill ranks by social engagement, which can surface things that are popular but not necessarily relevant. For example, a Reddit thread with 1,500 upvotes might be a meme, not an answer to your question. The skill's synthesis judge is supposed to filter that, but the README does not guarantee it. If you need a more controlled research process, Perplexity's Deep Research mode is a more structured alternative, but it does not have the same breadth of social sources.

Maintenance, License, and Upgrade Cost

The upgrade cost is low in terms of effort, but there is a hidden cost: each source connector may break when a platform changes its API. The README mentions bringing your own keys and browser sessions, which means you are responsible for maintaining those credentials. If X changes its API terms or YouTube changes its transcript access, the skill may need an update. The active release schedule suggests the author is keeping up, but you should be prepared to check for updates if a source stops working. There is no mention of a support channel or issue tracker in the README, so troubleshooting may rely on the repository's issues section, which is not described.

Editorial conclusion

Adopt last30days-skill if you are an AI agent user who needs a quick, engagement-ranked brief on a person, company, or topic, especially before meetings or product decisions. Do not adopt it if you require strict source control or if you cannot manage per-platform API keys and browser sessions for X, YouTube, and TikTok. Before relying on it, verify which sources work without configuration (Reddit, HN, Polymarket, GitHub) and which require the setup wizard, then test a single query to confirm the synthesis quality matches your needs. The project is MIT-licensed and actively maintained, but the value depends on your willingness to connect walled-garden accounts.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community notes

Community notes