A cost-aware personal analytics engine for X (Twitter) that tracks engagement, mentions, and follower growth with built-in budget protection.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install x-smart-read
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install x-smart-read using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Personal X (Twitter) Analytics?
The X (Twitter) Personal Analytics skill is a robust toolset designed for developers and power users to monitor their social presence with precision. By leveraging Openclaw Skills, this integration provides a programmatic way to analyze timeline engagement, track follower deltas, and manage bookmarks. It is specifically engineered to be cost-effective, utilizing a persistent local store to minimize expensive API calls while offering a transparent budget management system.
This skill enables users to stay informed through automated daily briefings and accountability checks without the need for manual platform browsing. It serves as a bridge between your terminal and the X API v2, ensuring that every interaction is both data-driven and financially guarded through customizable budget tiers and enforcement modes.
Personal X (Twitter) Analytics Use Cases
- Generate a comprehensive morning briefing including posts, mentions, and profile updates.
- Monitor account engagement and follower growth trends over specific lookback periods.
- Fetch and archive full tweet threads or individual posts via URL or ID.
- Conduct accountability checks to monitor personal activity levels and time spent on the platform.
- Manage bookmarks and save important tweets for future reference or research.
How Personal X (Twitter) Analytics Works
- The user initializes the skill by running the setup script to securely store X API v2 credentials and define a daily budget tier.
- When a command is triggered, the system first evaluates the request against the local persistent store to see if data can be served without a cost.
- If an API call is required, the skill verifies the remaining daily budget based on the selected enforcement mode (guarded, relaxed, or unlimited).
- Data is fetched from the X API, processed for engagement metrics, and simultaneously cached in the local storage for future zero-cost retrieval.
- The skill outputs a detailed summary including the requested data and a transparent report of the transaction cost and total daily spend.
Personal X (Twitter) Analytics Setup
To integrate this capability into your Openclaw Skills workflow, ensure you have the uv package manager installed. Begin by running the interactive setup script to configure your environment:
uv run scripts/x_setup.py
Once configured, you can validate your credentials and check your spend report using the following commands:
# Validate your setup
uv run scripts/x_setup.py --check
# Review your current API expenditure
uv run scripts/x_setup.py --spend-report
Personal X (Twitter) Analytics Data Schema & Taxonomy
The skill manages information through a structured local database and metadata taxonomy to ensure data persistence and cost efficiency.
| Component | Description |
|---|---|
| Local Cache | Stores full tweet objects, threads, and user profile snapshots to avoid redundant API hits. |
| Engagement Metrics | Tracks likes, retweets, and replies for your timeline posts. |
| Follower Delta | Records historical snapshots of follower counts to track growth over time. |
| Spend Log | A dedicated registry of every API transaction, including timestamps and cost per call. |
| Budget Config | Defines the daily limit (lite, standard, intense) and enforcement logic. |
Personal X (Twitter) Analytics Advanced Features
- Intelligent caching that prioritizes local storage to provide zero-cost data retrieval for repeat queries.
- Granular budget management with three distinct tiers to prevent unexpected API billing.
- Dry-run functionality allowing users to preview the exact cost of a command before execution.
- Accountability 'activity' checks designed to nudge users during work hours based on post frequency.
- Context-aware mentions tracking that can optionally fetch entire reply chains for deep engagement analysis.
SKILL.md
Loading
Related Openclaw Skills
iblai-router
A zero-dependency proxy that automatically routes requests to the cheapest capable AI model using a 14-dimension weighted scoring engine.
gmail_last5
A streamlined CLI utility to fetch and display the five most recent unique emails from your Gmail inbox.
Anthropology Instructor
A comprehensive AI skill delivering 580,000 tokens of curated content across all four subfields of anthropology through narrative-driven teaching.
Startup Research (startups.in)
A comprehensive research tool for tracking startup funding, hiring trends, and acquisitions via the startups.in database.
Mobile Appium Test
A specialized skill for automating Android UI testing on physical devices using Appium and ADB within the Openclaw Skills framework.
Session Archive & Backup System
A comprehensive session lifecycle management workflow for Openclaw agents that automates archiving, AI-driven summarization, and multi-cloud backups.
Featured*
