4e0f4f7413
Also add install command and cookie auth note to SKILL.md. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
62 lines
2 KiB
Markdown
62 lines
2 KiB
Markdown
---
|
|
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
|