diff --git a/README.md b/README.md
index 008b6ec..169c119 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,9 @@ twitter-cli ships with a [`SKILL.md`](./SKILL.md) so AI agents can execute commo
 #### Claude Code / Antigravity
 
 ```bash
+# Recommended: install the skill directly from GitHub
+npx skills add jackwener/twitter-cli
+
 # Clone into your project's skills directory
 mkdir -p .agents/skills
 git clone git@github.com:jackwener/twitter-cli.git .agents/skills/twitter-cli
@@ -278,6 +281,9 @@ twitter-cli 提供了 [`SKILL.md`](./SKILL.md)，可让 AI Agent 更稳定地调
 #### Claude Code / Antigravity
 
 ```bash
+# 推荐：直接从 GitHub 安装 skill
+npx skills add jackwener/twitter-cli
+
 # 克隆到项目 skills 目录
 mkdir -p .agents/skills
 git clone git@github.com:jackwener/twitter-cli.git .agents/skills/twitter-cli
diff --git a/SKILL.md b/SKILL.md
index b3b0b81..37ad1da 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,14 @@
 ---
 name: twitter-cli
-description: Read Twitter/X timeline, bookmarks, and user posts from terminal without API keys
+description: CLI skill for Twitter/X to read timelines, bookmarks, user posts, and profiles from the terminal without API keys
+author: jackwener
+version: "1.0.0"
+tags:
+  - twitter
+  - x
+  - social-media
+  - terminal
+  - cli
 ---
 
 # twitter-cli Skill