X-bookmark-research/skills/x-bookmark-research/SKILL.md

name	description	version	author	license
X Bookmark Research	Transform Twitter/X bookmarks into structured research markdown files with AI-powered analysis	1.0.0	Community	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