← Back to Skills Marketplace
seandong

X Timeline Digest

by seandong · GitHub ↗ · v1.0.2
cross-platform ✓ Security Clean
2396
Downloads
9
Stars
4
Active Installs
3
Versions
Install in OpenClaw
/install x-timeline-digest
Description
Build a deduplicated digest from X (Twitter) For You and Following timelines using bird. Outputs a payload for upstream delivery.
Usage Guidance
This skill appears to do what it says, but check the following before installing: - bird must be installed and already authenticated; bird will access your account timelines using whatever cookies/credentials it already has, so only install if you trust the local bird binary and its auth state. - The skill stores deduplication state at ~/.openclaw/state/x-timeline-digest.json (tweet IDs and timestamps) and keeps IDs ~30 days; if you care about local privacy you may want to inspect or relocate that file. - The script does not call any remote endpoints itself (other than invoking bird); the LLM-based Chinese summarization is expected to be performed by the agent you run (PROMPT.md + digest.json). That means the skill itself doesn't need API keys, but the agent or workflow that does the LLM summarization will — review where you send digest.json and which LLM/API keys you provide. - The implementation uses execFileSync('bird', ...) which is safer than shell execution, but confirm the 'bird' binary on your system is the expected tool and not an unexpected wrapper. - If you want exact behavior matching SKILL.md wording (automatic Chinese digest generation inside the script), note the current script only emits JSON and a simple concatenation; the LLM step is manual/agent-driven. Overall: coherent and low-risk for its purpose; proceed if you trust the local bird installation and the agent/workflow you will use for LLM summarization.
Capability Analysis
Type: OpenClaw Skill Name: x-timeline-digest Version: 1.0.2 The skill bundle is designed to fetch and process X (Twitter) timelines using an external `bird` binary. The `digest.js` script uses `execFileSync` to invoke `bird` with controlled arguments, mitigating shell injection risks. File system operations are limited to a designated state file (`~/.openclaw/state/x-timeline-digest.json`). Both `SKILL.md` and `PROMPT.md` provide instructions for the OpenClaw agent and an LLM, respectively, but neither contains any malicious prompt injection attempts or directives for unauthorized actions. The overall behavior aligns with the stated purpose of creating a tweet digest without evidence of intentional harmful behavior like data exfiltration or persistence.
Capability Assessment
Purpose & Capability
Name/description match required artifacts: the skill requires the 'bird' CLI (used in digest.js) and processes For You and Following feeds. No unrelated credentials, binaries, or install steps are requested.
Instruction Scope
SKILL.md promises a Chinese categorized digest and points to PROMPT.md; digest.js produces a JSON payload and a simple concatenated digestText but does not itself call an LLM. This is a reasonable split (script outputs items; agent/LLM performs final summarization) but is a minor mismatch between the phrasing and implementation that you should be aware of.
Install Mechanism
No install spec; instruction-only with a bundled Node script. The script uses only Node built-ins and calls the local 'bird' binary. Nothing is downloaded from remote URLs or written into system locations beyond a state file under the user's home directory.
Credentials
The skill requests no environment variables or external API keys. It expects the user to have an authenticated 'bird' installation (cookie-based) — that is appropriate and proportional for reading timelines. It does write a local state file (~/.openclaw/state/x-timeline-digest.json) to track sent tweet IDs.
Persistence & Privilege
always:false (no forced inclusion). The only persistent artifact is a per-user state file in ~/.openclaw/state to store lastRunAt and sentTweetIds for ~30-day retention; the skill does not modify other skills or global agent configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install x-timeline-digest
  3. After installation, invoke the skill by name or use /x-timeline-digest
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Fix security vulnerability: replaced child_process.execSync with execFileSync to prevent command injection risks.
v1.0.1
x-timeline-digest 1.0.1 - Added latest_digest.json to track or sample the current output. - Enhanced Processing Pipeline: Now explicitly generates a categorized Chinese digest, grouped as AI & Tech, Crypto & Markets, Insights, and Other. - Updated documentation in SKILL.md and PROMPT.md to clarify output format, categorization, and usage of the LLM-based summarization step. - No changes to core functionality or dependencies.
v1.0.0
x-timeline-digest 1.0.0 - Initial release - Fetches recent tweets from X/Twitter "For You" and "Following" timelines using bird. - Deduplicates and ranks tweets; merges near-duplicates by text similarity. - Filters incrementally to avoid reprocessing previously sent tweets. - Generates a summarized digest in Chinese with a structured payload for upstream use. - Includes configurable options for fetch limits, window interval, and deduplication threshold. - Requires bird CLI installed and authenticated; delivery is handled by upstream system.
Metadata
Slug x-timeline-digest
Version 1.0.2
License
All-time Installs 4
Active Installs 4
Total Versions 3
Frequently Asked Questions

What is X Timeline Digest?

Build a deduplicated digest from X (Twitter) For You and Following timelines using bird. Outputs a payload for upstream delivery. It is an AI Agent Skill for Claude Code / OpenClaw, with 2396 downloads so far.

How do I install X Timeline Digest?

Run "/install x-timeline-digest" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is X Timeline Digest free?

Yes, X Timeline Digest is completely free (open-source). You can download, install and use it at no cost.

Which platforms does X Timeline Digest support?

X Timeline Digest is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created X Timeline Digest?

It is built and maintained by seandong (@seandong); the current version is v1.0.2.

💬 Comments