# Send X Smart Read to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "x-smart-read", "name": "X Smart Read", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/nevaaron/x-smart-read", "canonicalUrl": "https://clawhub.ai/nevaaron/x-smart-read", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/x-smart-read", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-smart-read", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "AGENTS.md", "CONTRIBUTING.md", "README.md", "SETUP.md", "SKILL.md", "references/x-api-quickref.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "x-smart-read", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T05:38:01.399Z", "expiresAt": "2026-05-18T05:38:01.399Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-smart-read", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x-smart-read", "contentDisposition": "attachment; filename=\"x-smart-read-2.0.4.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "x-smart-read" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/x-smart-read" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/x-smart-read", "downloadUrl": "https://openagent3.xyz/downloads/x-smart-read", "agentUrl": "https://openagent3.xyz/skills/x-smart-read/agent", "manifestUrl": "https://openagent3.xyz/skills/x-smart-read/agent.json", "briefUrl": "https://openagent3.xyz/skills/x-smart-read/agent.md" } } ``` ## Documentation ### X (Twitter) Personal Analytics Monitor your X account — posts, engagement, mentions, followers. Read any tweet. Built for daily briefings and accountability. ### Triggers Use this skill when the user asks about: Their X / Twitter posts, timeline, or engagement Mentions, replies, or who's talking about them on X Follower count, profile stats, follower growth "What's happening on my X?" / "How are my posts doing?" "Check my Twitter mentions" / "Any new replies?" Morning briefing / daily social media summary "Am I on X too much?" / accountability check Reading a specific tweet or thread (user sends a tweet URL) "What did @someone say?" / reading other people's tweets Bookmarking or saving tweets for later X/Twitter analytics or performance ### Prerequisites Run setup first (imports credentials from ~/.openclaw/.env or prompts interactively): uv run scripts/x_setup.py ### Briefing — combined morning summary # Full briefing: your posts + mentions + profile (last 24h, ~$0.02) uv run scripts/x_briefing.py # Custom lookback period uv run scripts/x_briefing.py --hours 48 # Preview cost uv run scripts/x_briefing.py --dry-run ### Timeline — your posts + engagement # Recent posts with engagement metrics uv run scripts/x_timeline.py recent # Last 5 posts uv run scripts/x_timeline.py recent --max 5 # Posts from last 24 hours uv run scripts/x_timeline.py recent --hours 24 # Top posts by engagement (from local store, no API call) uv run scripts/x_timeline.py top --days 7 # Refresh metrics for a specific tweet uv run scripts/x_timeline.py refresh TWEET_ID # Accountability check — are they on X right now? uv run scripts/x_timeline.py activity ### Mentions — who's talking to/about you # Recent mentions uv run scripts/x_mentions.py recent # Mentions from last 24 hours uv run scripts/x_mentions.py recent --hours 24 # Mentions with context (shows what they replied to — costs extra) uv run scripts/x_mentions.py recent --context ### Read — fetch any tweet or thread # Read a tweet by URL uv run scripts/x_read.py https://x.com/user/status/123456 # Read by bare ID uv run scripts/x_read.py 123456 # Fetch full thread uv run scripts/x_read.py 123456 --thread # Preview cost uv run scripts/x_read.py --dry-run https://x.com/user/status/123456 ### Bookmarks — save and manage # List your bookmarks uv run scripts/x_bookmarks.py list # Bookmark a post uv run scripts/x_bookmarks.py add TWEET_ID # Remove a bookmark uv run scripts/x_bookmarks.py remove TWEET_ID ### User Profile — stats + follower tracking # Your profile stats uv run scripts/x_user.py me # Track follower changes over time uv run scripts/x_user.py me --track # Look up another user uv run scripts/x_user.py lookup someuser ### Setup & Spend # Validate credentials uv run scripts/x_setup.py --check # Show config (secrets redacted) uv run scripts/x_setup.py --show # Weekly spend summary uv run scripts/x_setup.py --spend-report # 30-day spend report uv run scripts/x_setup.py --spend-report --days 30 # Set budget mode uv run scripts/x_setup.py --budget-mode relaxed # Print version uv run scripts/x_setup.py --version ### Cost Control Flags (all scripts) # Preview cost without making the API call uv run scripts/x_timeline.py --dry-run recent # Override budget guard uv run scripts/x_timeline.py --force recent # Skip all budget checks and warnings uv run scripts/x_timeline.py --no-budget recent ### Morning Brief uv run scripts/x_briefing.py Single command replaces running timeline + mentions + user separately. Costs ~$0.02. ### Accountability Check uv run scripts/x_timeline.py activity Use this when the user should be working — it shows when they last posted and how active they've been. Nudge them if they're spending too much time on X. ### Weekly Review uv run scripts/x_timeline.py top --days 7 uv run scripts/x_user.py me --track ### Agent Guidelines — READ THIS BEFORE CALLING ANY COMMAND Every command costs real money. The X API charges per request. Follow these rules to minimize spend: ### Rules Never call the same command twice in one conversation unless the user explicitly asks for fresh data. The scripts cache locally — if you already ran recent this session, just reference those results. Prefer top over recent for repeat questions. top reads from the local store for free ($0). recent hits the API ($0.005). Don't use --context on mentions by default. It costs an extra $0.005 per reply thread it fetches. Only add it if the user specifically asks "what were they replying to?" Use --max 5 for quick checks. Default is 10-20. If the user just wants a summary, pull fewer. Use --hours 24 for briefings. Don't pull the full timeline when they just want "what happened today." Never run all scripts unprompted. If the user asks "what's happening on my X?", use x_briefing.py instead of running 3 separate commands. For accountability checks, use activity only. It's a single API call. Don't also pull mentions and profile — that triples the cost. top and refresh are your friends. top is free (local data). refresh TWEET_ID updates just one tweet ($0.005) — use it when they ask "how's my last post doing?" instead of re-pulling the whole timeline. Watch the daily spend total. Every command output shows "Today's spend: $X.XXX". If it's approaching the budget limit, tell the user before making more calls. Never loop or retry on your own. If a command fails (402, rate limit, etc.), report the error. Don't retry automatically. x_read.py caches tweets — if the user asks about the same tweet again, it's already in the local store. No need to re-fetch. Use x_briefing.py for morning briefings instead of running timeline + mentions + user separately. It's cheaper ($0.02 vs $0.02 for 3 separate commands) and cleaner output. ### Cost Reference ActionCostWhen to usex_briefing.py$0.02Morning briefing — one command does it allrecent$0.005Once per briefing, or when user asks for new poststop$0Anytime — serves from local storeactivity$0.005Accountability check, once per session maxrefresh ID$0.005User asks about a specific post's performancementions recent$0.005Once per briefing, or user asks about repliesmentions --context$0.005-0.03Only when user explicitly wants reply contextx_read.py URL$0.005User sends a tweet URL or asks to read a postx_read.py --thread$0.005-0.01User asks for full threadx_bookmarks.py list$0.005User wants to see saved bookmarksx_bookmarks.py add/remove$0Write actions are freeuser me$0.01Profile check, once per day is plentyuser me --track$0.01Morning brief only — saves follower deltauser lookup$0.01Only when user asks about another account--spend-report$0Check spending anytime--dry-run$0Preview cost before any command ### Budget Modes The user can set a budget enforcement mode via x_setup.py --budget-mode: guarded (default): Warn at 50/80/100%, block at limit relaxed: Warn at 50/80/100%, never block unlimited: No warnings, no blocks ### Budget Tiers The user set a daily budget during setup. The scripts will warn and block when the limit is hit: lite: $0.03/day (~1 briefing) standard: $0.10/day (~3-5 checks) intense: $0.25/day (~10+ checks) If blocked, tell the user: "Daily X API budget reached. Use --force to override, or wait until tomorrow." ### What NOT to do Don't run commands "just to have fresh data" — only fetch when the user needs it Don't use --no-cache unless debugging Don't call user lookup on multiple accounts in a loop Don't refresh every tweet's metrics — only refresh specific ones the user asks about Don't combine recent + mentions + user in one response — use x_briefing.py instead ## Trust - Source: tencent - Verification: Indexed source record - Publisher: nevaaron - Version: 2.0.4 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T05:38:01.399Z - Expires at: 2026-05-18T05:38:01.399Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/x-smart-read) - [Send to Agent page](https://openagent3.xyz/skills/x-smart-read/agent) - [JSON manifest](https://openagent3.xyz/skills/x-smart-read/agent.json) - [Markdown brief](https://openagent3.xyz/skills/x-smart-read/agent.md) - [Download page](https://openagent3.xyz/downloads/x-smart-read)