# X Bookmark Research

> Transform Twitter/X bookmarks into structured research markdown files with AI-powered analysis Use when this capability is needed.

- Skill: `tomevault-io/x-bookmark-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/x-bookmark-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/x-bookmark-research/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/x-bookmark-research

---


# 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/matthewod11-stack) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->