name: skill-reader version: "1.0.0" description: "深入解讀任意 Skill 的使用方法。輸入 Skill 名稱、安裝地址或 SKILL.md 文件，輸出結構化的使用說明：主要功能、使用場景、核心命令、安裝依賴、API Key 需求、版本號、注意事項等。Triggers: skill reader, 讀skill, 解讀skill, skill怎麼用, skill guide, skill manual, skill usage, 如何使用skill."

Skill Reader - Skill 使用說明書生成器

版本：2026040601

像買電器看說明書一樣——你不需要懂電路，只需要知道按哪個鍵、出什麼效果。

專治："裝了一堆 skill 但不知道怎麼用"、"這個 skill 到底幹啥的"。

適用場景

• 安裝了複雜 skill（如 superpower、gstack、baoyu 系列），不知道從哪下手
• 評估一個 skill 是否值得安裝——先看說明書再決定
• 給團隊成員生成 skill 使用指南
• 自己忘了某個 skill 怎麼用，快速回顧

輸入方式

1. Skill 名稱 — 已安裝的 skill，如 baoyu-image-gen
2. 安裝地址 — ClawHub URL 或 GitHub URL
3. SKILL.md 文件路徑 — 本地檔案路徑

輸出格式（核心改進版）

🏷️ 第一層：速覽卡（30 秒讀完）

## 📌 [Skill Name] — 一句話說明
[大白話，10-15 字]

**幫我做什麼**：[用 2-3 個口語化場景描述，不要用技術術語]
**跟你說什麼就能用**：[2-3 個自然語言觸發詞示例]
**要不要錢**：[免費 / 需要付費 Key / 有免費額度]
**值得裝嗎**：[⭐⭐⭐⭐⭐ 星級評分 + 一句話推薦理由]

📖 第二層：完整說明書（需要時展開）

---

## 🎯 它能幹什麼
[3-5 個核心功能，每個用"使用者能獲得的成果"來描述，不描述技術實現]
[例：❌ "呼叫 Google Gemini API 生成影像" → ✅ "你描述想要什麼畫面，它幫你畫出來"]

## 🗺️ 使用場景（帶真例項子）

### 場景 1：[場景名]
- 你說什麼：「幫我畫一張XX的封面圖」
- 它做什麼：[具體產出]
- 貼士：[使用建議]

### 場景 2：[場景名]
...

## ⚡ 怎麼用（對話式）
[用"你 → AI"的對話格式展示，不展示命令列]

### 最簡單的用法
你說：「[自然語言示例]」
AI 做：[產出結果]

### 進階用法
你說：「[帶引數的自然語言示例]」
AI 做：[更精準的產出]

## 🔑 要準備什麼
[按必要性排序]

### 必須有（沒有就不能用）
- [依賴 1]：怎麼獲取 → [具體步驟，包括連結]

### 最好有（沒有也能用，但效果更好）
- [依賴 2]：...

### 可選（錦上添花）
- [依賴 3]：...

## 💰 費用說明
[如果有 API 費用，給出大致估算：比如"一張圖約 0.01 元"]
[標註免費額度：比如"Google 每月免費 15 張"]

## 🚦 推薦決策

| 你想做什麼 | 用這個 | 還是那個 |
|-----------|--------|---------|
| 畫封面圖 | ✅ 這個 | → baoyu-cover-image 更專業 |
| 小紅書配圖 | ❌ 別用 | → baoyu-xhs-images 專門做這個 |
| 隨便畫一張 | ✅ 可以 | → ai-image-generation 模型更多 |

## ⚠️ 踩坑記錄
[如果能實際測試，記錄真實踩坑經驗；不能測試則基於文件推測]
- [坑 1]：[現象] → [解決方案]
- [坑 2]：...

## 🧩 它和其他 Skill 的關係
[用簡單的關係圖或文字描述]
[例："baoyu-image-gen 是底層發動機，cover-image 和 xhs-images 是在它上面做的專用車型"]

工作流程

Step 1: 獲取 Skill 文件

• 已安裝：讀 skills/<name>/SKILL.md，順便檢查 README.md、package.json、.env.example
• ClawHub URL：clawhub info <name> 或 web_fetch
• GitHub URL：web_fetch 抓取

Step 2: 實地探測（不只是讀文件）

• 檢查輔助檔案：package.json（依賴、版本）、.env.example（需要配什麼）
• 掃描 scripts/ 目錄：瞭解實際執行方式
• 查 git log：最近一次更新是什麼時候
• 儘量實際跑一遍（如果條件允許）：記錄速度、效果、報錯

Step 3: 關聯分析

• 在已安裝 skill 中找重疊/互補/依賴關係
• 標註哪個是底層、哪個是上層封裝
• 如果有多個 skill 做類似的事，給推薦決策表

Step 4: 生成說明書

語言鐵律： - ❌ 禁止出現命令列程式碼（除非是純技術 skill） - ❌ 禁止用技術術語當主語（"呼叫 API" → "它去問了 Google"） - ❌ 禁止羅列引數列表（放附錄，使用者需要時再展開） - ✅ 全部用"你說什麼 → 它做什麼"的對話格式 - ✅ 費用必須寫清楚，不要讓使用者事後才發現要錢 - ✅ 如果文件本身寫不清楚，如實標註"📖 文件描述模糊，建議實際測試"

特殊處理規則

Baoyu 系列（Skill 集合）

• 先給全家福：整個系列的定位 + 子 skill 關係圖
• 標註推薦入口：普通使用者應該從哪個子 skill 開始用
• 標註底層 vs 上層：底層 skill 不需要直接碰

複雜 Skill（SKILL.md > 200 行）

• 強制分層：速覽卡 → 模組概覽 → 詳細說明
• 標註"核心模組"和"可選模組"
• 可選模組一句話帶過，別展開

需要外部 API 的 Skill

• 費用必須量化：不要只寫"需要 API Key"，要說清楚"多少錢、有沒有免費額度、用完怎麼辦"
• 獲取路徑完整：給連結、給步驟、給截圖位置
• 優先推薦免費方案：如果 Google 和 OpenAI 都能用，優先推薦 Google（有免費額度）

與現有 Skill 功能重疊的情況

• 給出推薦決策表（見輸出格式）
• 不要兩邊都推薦，給一個明確結論

限制

• 無法保證 100% 準確（有些 skill 行為和文件不一致）

  小蔥技能7w4.net有更新，你可以訪問看下。

• 費用估算基於文件，實際可能不同
• 不替代實際測試——說明書是起點，不是終點

與 skill-catalog 的關係

組合使用： 先用 skill-catalog 找到 skill → 再用 skill-reader 讀說明書。

這是一個相當實用的 Skill，能幫你快速搞懂任意 Skill 怎麼用。它把複雜的技術文件翻譯成通俗易懂的使用說明，還貼心地設計了「30秒速覽卡」讓你快速判斷要不要深入瞭解。文件寫得很有條理，考慮了各種使用場景。不過缺少實際使用案例的展示，想知道效果好不好可能得自己試試。