x-knowledge-base

What This Skill Does

The x-knowledge-base skill is an advanced automation agent designed to transform your ephemeral X (Twitter) bookmarks into a structured, evergreen Obsidian knowledge base. Unlike simple bookmarking tools, this skill acts as an intelligent librarian and researcher. It utilizes Jina AI to scrape the full content of bookmarked threads and articles, processes them through the MiniMax API to generate concise summaries, actionable key points, and relevant application scenarios. Furthermore, it automatically injects YAML frontmatter and Wiki-links into your Markdown files to ensure seamless integration into your existing Obsidian workflow.

Beyond collection, the skill features a sophisticated "self-evolution" engine. By maintaining a dynamic trends.json file, it tracks your personal interest evolution, identifies emerging tags, and calculates growth scores for topics you consume. This allows the AI to proactively suggest relevant keywords, adjust your research focus, and keep you ahead of your own learning curve.

Installation

1. Ensure you have Python 3.10+ installed on your system.
2. Install the skill via the OpenClaw repository: clawhub install openclaw/skills/skills/hidicence/x-knowledge-base.
3. Configure your environment variables in your .env file:
   • BIRD_AUTH_TOKEN and BIRD_CT0 for X/Twitter access.
   • MINIMAX_API_KEY to enable AI enrichment features.
   • OBSIDIAN_VAULT_PATH to point to your local vault directory.
4. (Optional) Provide BRAVE_SEARCH_API_KEY to enhance trend analysis with external web intelligence.

Use Cases

• Personal Knowledge Management: Automatically curate long-form X threads into your personal notes without manual copying.
• Trend Intelligence: Track which niche topics (e.g., 'vibe-coding' or 'AI automation') are becoming dominant in your saved bookmarks over time.
• Automated Research: Use the AI-generated 'application scenarios' to brainstorm how to apply new insights immediately to your current projects.

Example Prompts

• "檢查我的書籤" - Triggers the agent to fetch new X bookmarks, summarize them, and save them as formatted Markdown files in your Obsidian vault.
• "今天的趨勢是什麼" - Generates an analytical report on your most saved topics, identifies rising trends, and suggests keywords for your daily information intake.
• "我的興趣變化了嗎" - Requests the agent to compare current bookmark tags against historical data to provide insights into how your learning focus has shifted.

Tips & Limitations

• Tips: Ensure your Obsidian vault syncs with a cloud provider if you want to access your knowledge base across devices. For better AI precision, keep your tags in X bookmarks consistent.
• Limitations: The tool depends on X/Twitter's rate limits; avoid excessive frequent requests. The quality of AI summarization depends on the availability of the web content via Jina AI; if a link is dead or behind a paywall, the tool may only save a partial capture.