x-bookmarks

What This Skill Does

The x-bookmarks skill transforms your X (formerly Twitter) saved posts into a manageable, actionable knowledge base within the OpenClaw environment. Rather than letting bookmarked tweets disappear into a digital void, this skill automates the retrieval, summarization, and categorization of your saved content. It acts as a bridge between your social media consumption and your personal productivity workflows. By leveraging either the lightweight 'bird' CLI or a robust X API v2 integration, it consistently extracts tweet metadata—including engagement metrics, media attachments, and thread context—into a unified, standardized JSON format that allows the AI to parse, analyze, or even draft responses based on your saved interests.

Installation

To integrate this skill into your environment, run the following command within your OpenClaw interface: clawhub install openclaw/skills/skills/sharbelayy/x-bookmarks

Once installed, the agent will attempt to auto-detect your authentication method. It prioritizes the bird CLI, which is ideal for quick, cookie-based sessions. If you prefer a more formal integration, the skill supports X API v2, requiring a one-time OAuth setup via the provided x_api_auth.py script. Configuration files are maintained securely in ~/.config/x-bookmarks/tokens.json to ensure persistence across sessions.

Use Cases

This skill is designed for power users who leverage social media for research, professional development, or inspiration. Common use cases include:

• Weekly Digest Creation: Summarizing all bookmarks from the past seven days to catch up on missed content.
• Content Curation: Automatically categorizing bookmarks by topic, such as 'AI research', 'design inspiration', or 'coding tips'.
• Actionable Tasking: Converting high-value informational threads into todo items or summary briefs for your project management tools.
• Social Listening: Analyzing patterns in what you save to identify emerging trends relevant to your industry.

Example Prompts

1. "Check my bookmarks from this week and provide a summary of the top three threads regarding AI agents."
2. "I'm feeling overwhelmed by my saves; can you categorize my last 50 bookmarks into folders based on their content?"
3. "Show me a list of my latest bookmarks and suggest which ones I should turn into a blog post."

Tips & Limitations

To maximize the utility of this skill, prioritize the bird CLI for speed if you frequently use a browser. Keep in mind that API rate limits apply if you use the X API v2 method; the tool handles auto-refreshing of tokens, but manual re-authentication may be required if your session expires. Always ensure you are running the latest version of the skill to maintain compatibility with changes to the X platform’s internal structure. If you have a massive collection of thousands of bookmarks, consider using the '--all' flag in the fetch command during off-peak hours to avoid potential throttling.