X-bookmark-research/skills/x-bookmark-research/SKILL.md
HomeBase 816ecd37e0 Initial release: X Bookmark Research for Claude Code
Claude Code extension that transforms Twitter/X bookmarks into structured
research markdown files. Reads config for output directory and user interests,
fetches bookmarks via bird CLI, and generates categorized notes with key
insights, author context, and actionable items.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 16:26:48 -08:00

1.9 KiB

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
    • Used to fetch bookmarks, read tweets, and look up author profiles
    • Must be authenticated before first use (bird auth)

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