docs: add AI skill and ClawHub sections with SKILL.md

SKILL.md

@@ -0,0 +1,64 @@
+# twitter-cli Skill
+
+Use this skill when the user wants to read Twitter/X content from terminal without API keys.
+
+## Requirements
+
+- `twitter-cli` installed and available in PATH.
+- User is logged in to `x.com` in Chrome/Edge/Firefox/Brave, or sets:
+  - `TWITTER_AUTH_TOKEN`
+  - `TWITTER_CT0`
+
+## Core Commands
+
+```bash
+# Home timeline (For You)
+twitter feed
+
+# Following timeline
+twitter feed -t following
+
+# Bookmarks
+twitter favorite
+
+# User profile and posts
+twitter user <screen_name>
+twitter user-posts <screen_name> --max 20
+```
+
+## JSON / Scripting
+
+```bash
+# Export feed as JSON
+twitter feed --json > tweets.json
+
+# Read from local JSON file
+twitter feed --input tweets.json
+```
+
+## Ranking Filter
+
+Filtering is opt-in (disabled by default). Enable with `--filter`.
+
+```bash
+twitter feed --filter
+twitter favorite --filter
+```
+
+The scoring formula:
+
+```text
+score = likes_w * likes
+      + retweets_w * retweets
+      + replies_w * replies
+      + bookmarks_w * bookmarks
+      + views_log_w * log10(max(views, 1))
+```
+
+Configure weights and mode in `config.yaml`.
+
+## Safety Notes
+
+- Do not ask users to share raw cookie values in chat logs.
+- Prefer local browser cookie extraction over manual secret copy/paste.
+- If auth fails with 401/403, ask the user to re-login to `x.com`.