---
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](https://github.com/steipete/bird)** - 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:

```bash
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