| name | X Bookmark Research |
| description | Transform Twitter/X bookmarks into structured research markdown files with AI-powered analysis |
| version | 1.0.0 |
| author | Community |
| license | MIT |
X Bookmark Research
A Claude Code skill that transforms your Twitter/X bookmarks into structured, actionable research notes.
What It Does
When you bookmark interesting tweets, this skill processes them into organized markdown files with:
- Key insights extracted from the content
- Author context (who they are, why their perspective matters)
- Personal relevance connected to your configured interests and projects
- Action items so bookmarks become actionable, not forgotten
Dependencies
Required
- bird CLI - Command-line tool for Twitter/X API access
- Install:
npm install -g @steipete/bird
- Uses cookie authentication from your browser (Safari/Chrome/Firefox)
- Used to fetch bookmarks, read tweets, and look up author profiles
Optional
- Exa MCP Server - Only needed for
--depth deep research mode
- Provides web search for broader context around tweet topics
- The skill gracefully degrades to
standard depth without it
Configuration
This skill reads its settings from ~/.claude/skills/x-bookmark-research/config.yml.
Copy the example config to get started:
cp ~/.claude/skills/x-bookmark-research/config.example.yml ~/.claude/skills/x-bookmark-research/config.yml
Then edit config.yml with your output directory and interests.
Usage
Invoke via the slash command:
/research-bookmarks # Interactive - asks how many and what depth
/research-bookmarks 5 # Process 5 recent bookmarks
/research-bookmarks all # Process all unprocessed bookmarks
/research-bookmarks <url> # Research a specific tweet
/research-bookmarks 10 --depth deep # 10 bookmarks with web research
References
references/output-format.md - Full output template specification and formatting guidelines
