x-bookmarks
by sharbelayy
Browser & AutomationBrief
Fetch, summarize, and manage X/Twitter bookmarks via bird CLI or X API v2.
Description
What This Skill Does
Fetches and manages X/Twitter bookmarks using either bird CLI (browser cookies) or X API v2 (OAuth 2.0). Bookmarks are categorized by topic, and each category gets proposed actions the agent can execute, not just summaries. Supports scheduled digests, content recycling, pattern detection, and stale bookmark cleanup.
Supports two authentication backends so it works without an API key via browser cookies, and proposes concrete executable actions per bookmark rather than just summarizing.
When to Use It
- Getting a weekly digest of saved tweets with action suggestions
- Categorizing bookmarks by topic like AI, crypto, or marketing
- Finding high-engagement bookmarks to reuse as content drafts
- Cleaning up bookmarks older than 30 days with one-line takeaways
- Tracking which topics appear most across your bookmark history
Example Workflow
User asks: Give me a digest of my X bookmarks
- 1
Auto-detect available backend: check for bird CLI first, fall back to X API v2
- 2
Fetch the latest 20 bookmarks in JSON format
- 3
Categorize bookmarks by topic (AI, tools, strategy, content, etc.)
- 4
For each category, propose specific actions the agent can take such as setting up a tool, drafting content, or summarizing advice
- 5
Flag bookmarks older than 2 weeks as stale with a use-it-or-lose-it prompt
Categorized bookmark digest grouped by topic, each entry with a proposed action the agent can execute
Requirements
- AUTH_TOKEN environment variable (X/Twitter auth token extracted from browser cookies, for bird CLI)
- CT0 environment variable (X/Twitter CSRF token extracted from browser cookies, for bird CLI)
- bird CLI non-standard tool install (npm i -g bird-cli), required for bird CLI backend
- X Developer account with OAuth 2.0 app credentials, required for X API v2 backend
- X_API_BEARER_TOKEN environment variable (optional, for X API v2 Bearer token auth)
Installation
clawhub install sharbelayy/x-bookmarksRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.