twitter-to-obsidian
Twitter to Obsidian Note Converter
This skill automates the process of extracting content from Twitter/X articles, analyzing and structuring the information, and saving it as a well-formatted Obsidian note.
When to Use This Skill
Use this skill when:
- User provides a Twitter/X URL (x.com or twitter.com) and wants to save it
- User mentions "save to Obsidian", "create a note", "save as note"
- User asks to "梳理" (organize/summarize) a Twitter article and save it
- User wants to extract and organize content from social media posts
Workflow
Step 1: Access the Twitter/X Content
Use Chrome DevTools MCP to access the Twitter/X page:
-
List available pages:
mcp__chrome-devtools__list_pages -
Navigate to URL (if not already open):
mcp__chrome-devtools__navigate_page type: url url: <twitter-url> -
Take snapshot to extract content:
mcp__chrome-devtools__take_snapshot
Step 2: Analyze and Structure Content
Extract the following information from the snapshot:
-
Metadata:
- Author name and handle
- Publication date/time
- Engagement metrics (replies, retweets, likes, bookmarks, views)
- Source URL
-
Main Content:
- Article title (if it's an X Article)
- Full text content
- Main sections and headings
- Code examples or diagrams (preserve formatting)
- Key images (note their descriptions)
-
Structured Summary:
- Core concepts/main points
- Key takeaways
- Practical examples
- Step-by-step instructions (if applicable)
- Related resources/links
Step 3: Format as Obsidian Note
Create a well-structured Markdown document with:
Required Sections:
-
Header with metadata:
# [Title] > **来源**: [Twitter/X - @username](url) > **作者**: Author Name > **发布时间**: YYYY年MM月DD日 > **保存时间**: YYYY年MM月DD日 --- -
概述 (Overview): Brief summary of the content
-
核心内容 (Core Content): Main body organized with:
- Clear headings (##, ###)
- Bullet points for lists
- Code blocks with language tags
- Tables for structured data
- Blockquotes for important quotes
- Emoji for visual hierarchy (optional, use sparingly)
-
相关资源 (Related Resources): Links mentioned in the article
-
标签 (Tags): Relevant tags with # prefix
-
个人笔记 (Personal Notes): Empty section for user's own thoughts
Formatting Best Practices:
- Use proper Markdown hierarchy (H1 for title, H2 for major sections, H3 for subsections)
- Preserve code formatting with triple backticks and language identifiers
- Use tables for comparisons or structured data
- Include ASCII diagrams if present in original content
- Add emoji sparingly for visual clarity (e.g., 🎯, 📌, ✅, ❌)
- Ensure all links are clickable Markdown links
- Use blockquotes (>) for important callouts or quotes
Step 4: Save to Obsidian
-
Determine the file path:
- Default Obsidian vault:
/Users/douba/Library/Mobile Documents/com~apple~CloudDocs/douba-OB - Use a descriptive filename based on the article title
- Replace special characters in filename with hyphens or spaces
- Default Obsidian vault:
-
Save the file:
Write tool file_path: /Users/douba/Library/Mobile Documents/com~apple~CloudDocs/douba-OB/[filename].md content: [formatted markdown content] -
Confirm success with the user:
- Report the save location
- Provide a brief summary of what was saved
- List the main sections included
Error Handling
If Browser Access Fails:
- Check if user has the Twitter/X page already open in Chrome
- Ask user to open the page manually
- Verify Chrome DevTools MCP connection
If Content Extraction is Incomplete:
- Notify user which sections are missing
- Explain what content was successfully extracted
- Offer to retry or ask user to provide missing information
If Save Fails:
- Verify the Obsidian vault path exists
- Check file permissions
- Suggest alternative save location if needed
Example Usage
User: "https://x.com/0xYuker/status/2013094122656334136 这篇文章的内容你梳理一下"
Process:
- Access the Twitter URL via Chrome DevTools
- Extract the article content about Multi-Agent systems
- Structure it with clear sections: overview, core concepts, implementation steps
- Save to Obsidian with metadata, tags, and formatted content
User: "你能够帮我直接存储到我的Obsidian里面,作为一篇笔记吗?"
Process:
- Use previously extracted content
- Format as Obsidian note with all required sections
- Save to specified Obsidian vault path
Tips for Quality Notes
- Preserve Structure: Maintain the logical flow of the original content
- Add Value: Don't just copy-paste; organize and clarify
- Context: Include metadata so notes are self-contained
- Searchability: Use relevant tags and clear headings
- Links: Preserve all URLs as clickable Markdown links
- Examples: Keep code examples and diagrams intact
- Visual Hierarchy: Use consistent heading levels and formatting
Output Style
- Be concise in status updates
- Confirm successful save with file path
- Highlight key sections that were included
- Use emoji sparingly for user-facing messages (✅ for success, ⚠️ for warnings)