← Back to Skills Marketplace
X Reader
by
AgentLinker
· GitHub ↗
· v0.1.0
· MIT-0
287
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install xlink-reader
Description
Read and summarize X/Twitter links with low-token routing. Use when a user shares an x.com/twitter.com/t.co link or asks to read, summarize, extract, or insp...
Usage Guidance
This skill largely does what it says (reads tweets, threads, and X articles), but there are a few things to check before installing:
- Expectation gap: The script requires an external 'xreach' CLI at runtime but the registry metadata/package.json do not declare or install it; install or inspect xreach yourself before relying on the skill.
- Sensitive data: The skill reads and will write X login cookies at ~/.config/xreader/session.json (and will migrate ~/.config/xfetch/session.json). Only provide cookie files from accounts you are willing to expose to automation — consider a secondary account.
- Playwright: The skill uses Playwright for article extraction; running npm install will fetch Playwright and browser binaries (large, with elevated I/O). Review and run npm install in a controlled environment if you have concerns.
- Verify behavior: Inspect the xreader.mjs script (already included) and the xreach binary source (if you install it) to confirm no unexpected network endpoints or exfiltration. Run the script against a benign public URL in debug mode to observe browser behavior before using private credentials.
If you want to proceed: install Playwright in the skill directory as instructed, separately install/verify xreach, and only point the skill at cookie files from a throwaway/secondary account. If you prefer a simpler approach, prefer a skill that uses only public API endpoints or explicit OAuth tokens rather than file-based cookie migration.
Capability Analysis
Type: OpenClaw Skill
Name: xlink-reader
Version: 0.1.0
The x-reader skill is a utility designed to scrape and summarize X (Twitter) posts and articles. It utilizes a local CLI dependency (xreach) and Playwright for browser automation, handling authentication via session cookies stored in the user's home directory (~/.config/xreader/session.json). The script (scripts/xreader.mjs) includes logic for URL resolution, content extraction, and data normalization, with no evidence of malicious behavior, unauthorized data exfiltration, or prompt injection vulnerabilities.
Capability Assessment
Purpose & Capability
The skill claims to read X/Twitter links and avoid the official API, which fits the included code. However, the runtime spawns an external 'xreach' CLI via execFile('xreach', ...), yet the registry metadata lists no required binaries and the package.json does not install or declare an 'xreach' dependency. SKILL.md does mention 'xreach' as a dependency, but the manifest omission is an incoherence: a user installing this skill must also install/obtain xreach separately for normal operation.
Instruction Scope
The SKILL.md and script instruct the agent to read local auth files (~/.config/xreader/session.json and legacy ~/.config/xfetch/session.json) and migrate/create a session file. Accessing and writing X auth cookies is sensitive but relevant to the stated purpose; however the registry metadata did not declare these required config paths. The script also uses network fetches and Playwright page evaluation (including running a headless/headed browser) which are expected for article extraction but expand the runtime surface.
Install Mechanism
There is no automated install spec in the registry, but SKILL.md explicitly instructs running `npm install` in the skill directory to obtain Playwright. Playwright (and its browsers) are heavyweight but legitimate for article rendering. No downloads from arbitrary URLs are present in the package files; the install flow is manual and documented, which lowers risk but requires user action.
Credentials
The skill requires valid X auth cookies (authToken and ct0) stored in the user's home config paths; this is proportionate to cookie-based scraping but is sensitive. The registry metadata declared no required config paths or credentials, creating a mismatch between what the skill actually needs and what was advertised. No unrelated credentials are requested, but the omission of declared config paths is notable.
Persistence & Privilege
The skill does write its own config (~/.config/xreader/session.json) and will migrate a legacy file if present; it does not request always:true, does not modify other skills or system-wide agent settings, and operates within its own config directory. This is expected behavior for a cookie-using tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xlink-reader - After installation, invoke the skill by name or use
/xlink-reader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
xlink-reader 0.1.0 changelog:
- Initial release of the x-reader skill for reading and summarizing X/Twitter links.
- Supports tweets, threads (with explicit command), and X articles with minimal token usage.
- Smart routing: prefers lightweight xreach for tweets/threads, uses Playwright only for article or t.co links that resolve to articles.
- Requires Node.js, xreach, and valid X auth cookies; no paid API access needed.
- Outputs structured JSON for simple summarization and reliable link handling.
- Includes clear documentation for installation, authentication, usage modes, and output contract.
Metadata
Frequently Asked Questions
What is X Reader?
Read and summarize X/Twitter links with low-token routing. Use when a user shares an x.com/twitter.com/t.co link or asks to read, summarize, extract, or insp... It is an AI Agent Skill for Claude Code / OpenClaw, with 287 downloads so far.
How do I install X Reader?
Run "/install xlink-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Reader free?
Yes, X Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Reader support?
X Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Reader?
It is built and maintained by AgentLinker (@zuolicong); the current version is v0.1.0.
More Skills