Skill Usage Analyzer
by @xiaoxiao19810912
Analyze any OpenClaw skill and generate a comprehensive usage guide. Extracts examples, best practices, configuration options, and common pitfalls from SKILL...
clawhub install skill-usage-analyzer๐ About This Skill
name: skill-usage-analyzer description: Analyze any OpenClaw skill and generate a comprehensive usage guide. Extracts examples, best practices, configuration options, and common pitfalls from SKILL.md files. Use when you want to quickly understand how to use a new skill without reading the full documentation. metadata: { "openclaw": { "emoji": "๐", "requires": { "bins": ["python3"] }, "notes": "Reads SKILL.md files and generates human-friendly summaries with actionable insights.", }, }
Skill Usage Analyzer
Quickly understand any OpenClaw skill by analyzing its SKILL.md file and generating a comprehensive usage guide.
Features
Quick Start
ๅๆๅไธชๆ่ฝ
# ๅๆๆๅฎๆ่ฝ
python3 scripts/analyze_skill.py /path/to/skill/SKILL.mdๅๆๅทฒๅฎ่ฃ
็ๆ่ฝ
python3 scripts/analyze_skill.py ~/.openclaw/workspace/skills/stock-watcher/SKILL.md
ๅๆๆๆๅทฒๅฎ่ฃ ๆ่ฝ
# ็ๆๆๆๆ่ฝ็ๅฟซ้ๅ่
python3 scripts/analyze_all.py
Usage Examples
Example 1: ๅๆ Stock Watcher ๆ่ฝ
่พๅ ฅ๏ผ
python3 scripts/analyze_skill.py ~/.openclaw/workspace/skills/stock-watcher/SKILL.md
่พๅบ็คบไพ๏ผ
๐ ๆ่ฝๅๆๆฅๅ: stock-watcher
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ๐ ๅบๆฌไฟกๆฏ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๅ็งฐ: stock-watcher
ๆ่ฟฐ: Manage and monitor a personal stock watchlist...
้็จๅบๆฏ: ่ก็ฅจ็ๆงใ่ช้่ก็ฎก็ใ่กๆ
ๆฅ็
๐ฏ ๆ ธๅฟๅ่ฝ (4ไธช)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
1. ๆทปๅ ่ก็ฅจ - ไฝฟ็จ6ไฝ่ก็ฅจไปฃ็ ๆทปๅ ๅฐ่ช้่ก
2. ๅ ้ค่ก็ฅจ - ๆไปฃ็ ๅ ้ค่ช้่ก
3. ๆฅ็ๅ่กจ - ๆพ็คบๅฝๅๆๆ่ช้่ก
4. ่กๆ
ๆป็ป - ่ทๅ่ก็ฅจ่กๆ
ๆ่ฆ
๐ป ไฝฟ็จ็คบไพ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๆทปๅ ่ก็ฅจ:
python3 scripts/add_stock.py 000938 "็ดซๅ
่กไปฝ"
ๆฅ็่กๆ
:
python3 scripts/summarize_performance.py
โ๏ธ ้
็ฝฎ้้กน
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๅญๅจ่ทฏๅพ: ~/.clawdbot/stock_watcher/watchlist.txt
ๆฐๆฎๆ ผๅผ: ไปฃ็ |ๅ็งฐ (ๆฏ่กไธไธช)
โ ๏ธ ๆณจๆไบ้กน
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โข ่ก็ฅจไปฃ็ ๆ ผๅผ: ไฝฟ็จ6ไฝๆฐๅญไปฃ็
โข ๆฐๆฎๅปถ่ฟ: ่กๆ
ๅฏ่ฝๆ1-3ๅ้ๅปถ่ฟ
โข ็ฝ็ปไพ่ต: ้่ฆ็ฝ็ป่ฟๆฅ่ทๅๅฎๆถๆฐๆฎ
๐ก ๆไฝณๅฎ่ทต
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
1. ๅฎๆๆธ
็ไธๅๅ
ณๆณจ็่ก็ฅจ
2. ็ปๅๆๆฏๅๆๆๆ ไฝฟ็จ
3. ่ฎพ็ฝฎไปทๆ ผ้ข่ญฆ๏ผ้้
ๅๅ
ถไปๅทฅๅ
ท๏ผ
Example 2: ๅฏนๆฏๅคไธชๆ่ฝ
python3 scripts/compare_skills.py skill1 skill2 skill3
Output Format
ๅๆๆฅๅๅ ๅซไปฅไธ้จๅ๏ผ
| ้จๅ | ๅ ๅฎน | |------|------| | ๐ ๅบๆฌไฟกๆฏ | ๆ่ฝๅ็งฐใๆ่ฟฐใ้็จๅบๆฏ | | ๐ฏ ๆ ธๅฟๅ่ฝ | ๅ่ฝๅ่กจ๏ผๅธฆๅบๅทๅ็ฎ่ฆ่ฏดๆ | | ๐ป ไฝฟ็จ็คบไพ | ๅ ทไฝ็ๅฝไปคๅไปฃ็ ็คบไพ | | โ๏ธ ้ ็ฝฎ้้กน | ๅฏ้ ็ฝฎๅๆฐๅ้ป่ฎคๅผ | | ๐ ๆไปถ็ปๆ | ๆ่ฝๅ ๅซ็ๆไปถๅ็ฎๅฝ | | โ ๏ธ ๆณจๆไบ้กน | ๅธธ่ง้ฎ้ขใ้ๅถใ้ฃ้ฉๆ็คบ | | ๐ก ๆไฝณๅฎ่ทต | ไฝฟ็จๅปบ่ฎฎๅไผๅๆๅทง | | ๐ ็ธๅ ณ้พๆฅ | ็ธๅ ณๆ่ฝใๆๆกฃ้พๆฅ |
Advanced Usage
่ชๅฎไน่พๅบๆ ผๅผ
# ่พๅบไธบ Markdown
python3 scripts/analyze_skill.py SKILL.md --format markdown่พๅบไธบ JSON
python3 scripts/analyze_skill.py SKILL.md --format jsonๅชๆพ็คบ็คบไพ
python3 scripts/analyze_skill.py SKILL.md --examples-only
ๆน้ๅๆ
# ๅๆๆๆๆ่ฝๅนถ็ๆ็ดขๅผ
python3 scripts/analyze_all.py --output ~/skill-index.mdๆฅๆพๅ
ๅซ็นๅฎๅ่ฝ็ๆ่ฝ
python3 scripts/search_skills.py "่ก็ฅจ" "็ๆง"
How It Works
1. ่ฏปๅ SKILL.md - ่งฃๆๆ่ฝ็ๅ ๆฐๆฎๅๆๆกฃๅ ๅฎน 2. ๆๅ็ปๆ - ่ฏๅซๆ ้ขใๅ่กจใไปฃ็ ๅ็ญ็ปๆ 3. ่ฏญไนๅๆ - ็่งฃๅ่ฝๆ่ฟฐๅไฝฟ็จๅบๆฏ 4. ็ๆๆฅๅ - ๆๆจกๆฟ็ป็ปไฟกๆฏ๏ผ็ๆๆ่ฏป็ๆ่ฆ
Creative Usage Ideas ๐ก
1. ๆ่ฝ็ปๅๆจ่
ๅๆๅคไธชๆ่ฝๅ๏ผ่ชๅจๅ็ฐๅฏไปฅ็ปๅไฝฟ็จ็ๆ่ฝๅฏน๏ผ# ๆพๅบๅฏไปฅ็ปๅไฝฟ็จ็ๆ่ฝ
python3 scripts/find_combinations.py
่พๅบ็คบไพ:
๐ ๆ่ฝ็ปๅๆจ่1. ๐ก ๅ
ๅฎนๅไฝๆตๆฐด็บฟ
ๆ่ฟฐ: ๆ็ดข่ตๆโๆป็ปโๅไฝโๅฝฑ่งๅ
ๅทฒๅฎ่ฃ
: tavily-search, summarize, novel-generator
ไฝฟ็จๅบๆฏ: ๆ็ดข็ญ็น่ฏ้ขโ็ๆๅฐ่ฏดโๆน็ผๅงๆฌ
2. ๐ก GitHub่ชๅจๅ
ๆ่ฟฐ: ็ฎก็starsใ่ชๅจไฟฎๅคissues
ๅทฒๅฎ่ฃ
: github-star-manager
ๆชๅฎ่ฃ
: gh-issues (ๅปบ่ฎฎๅฎ่ฃ
)
ไฝฟ็จๅบๆฏ: ๆธ
็่ฟๆถ็ starred repos
๐ฎ ๅบไบๆ่ฟฐๅๆ็ๆฝๅจ็ปๅ:
โข ๆฐๆฎ็ธๅ
ณ: stock-watcher, tavily-search
โข ๅ
ๅฎน็ธๅ
ณ: novel-generator, film-production-assistant
2. ๆ่ฝไพ่ตๅพ่ฐฑ
็ๆๆ่ฝไน้ด็ไพ่ตๅ ณ็ณปๅพ๏ผ# ็ๆไพ่ตๅ
ณ็ณปๅพ๏ผMermaid ๆ ผๅผ๏ผ
python3 scripts/dependency_graph.py --format mermaid่พๅบ:
graph TD
stock-watcher --> cron
github-star-manager --> gh
novel-generator --> openai
3. ๆ่ฝไฝฟ็จ้ข็ๅๆ
ๅๆๅทฅไฝๅบไธญไฝฟ็จ่ฎฐๅฝ๏ผๆพๅบๆๅธธ็จ็ๆ่ฝ๏ผ# ๅๆไฝฟ็จ้ข็
python3 scripts/usage_stats.py --days 30่พๅบ:
๐ ่ฟ30ๅคฉๆ่ฝไฝฟ็จ็ป่ฎก:
1. stock-watcher: 45ๆฌก (35%)
2. github-star-manager: 23ๆฌก (18%)
3. novel-generator: 12ๆฌก (9%)
4. ๆ่ฝ่ฝๅๆ ็ญพไบ
ไธบๆๆๆ่ฝ็ๆ่ฝๅๆ ็ญพ๏ผๅฟซ้ๆพๅฐ้่ฆ็ๅ่ฝ๏ผ# ็ๆ่ฝๅๆ ็ญพไบ
python3 scripts/generate_tags.py่พๅบ:
๐ท๏ธ ๆ่ฝ่ฝๅๆ ็ญพ:
ๆฐๆฎ่ทๅ: stock-watcher, github-star-manager, tavily-search
ๅ
ๅฎนๅไฝ: novel-generator, film-production-assistant
ไปฃ็ ๅผๅ: gh-issues, agent-browser
5. ๆบ่ฝๆ่ฝๆจ่
ๆ นๆฎๅฝๅไปปๅกๆ่ฟฐ๏ผๆจ่ๆ้ๅ็ๆ่ฝ๏ผ# ๆบ่ฝๆจ่
python3 scripts/recommend_skill.py "ๆๆณ็ๆง่ก็ฅจๅนถ่ชๅจๅ้้็ฅ"่พๅบ:
๐ก ๆจ่ๆ่ฝ็ปๅ:
1. stock-watcher (่ก็ฅจ็ๆง)
2. qqbot-cron (ๅฎๆถไปปๅก)
3. qqbot-media (ๅ้้็ฅ)
#
ไฝฟ็จๆต็จ:
1. ็จ stock-watcher ๆทปๅ ่ก็ฅจ
2. ็จ qqbot-cron ่ฎพ็ฝฎๅฎๆถๆฃๆฅ
3. ็จ qqbot-media ๅ้ไปทๆ ผๆ้
6. ๆ่ฝๅญฆไน ่ทฏๅพ
ไธบๆฐๆ็ๆๆ่ฝๅญฆไน ่ทฏๅพ๏ผ# ็ๆๅญฆไน ่ทฏๅพ
python3 scripts/learning_path.py --goal "่ชๅจๅๅ
ๅฎนๅไฝ"่พๅบ:
๐ ๅญฆไน ่ทฏๅพ: ่ชๅจๅๅ
ๅฎนๅไฝ
#
้ถๆฎต1: ๅบ็ก (1-2ๅคฉ)
โโ summarize (ๅ
ๅฎนๆป็ป)
โโ tavily-search (่ตๆๆ้)
#
้ถๆฎต2: ่ฟ้ถ (3-5ๅคฉ)
โโ novel-generator (ๅฐ่ฏด็ๆ)
โโ prompt-engineer-ultra (ๆ็คบ่ฏไผๅ)
#
้ถๆฎต3: ้ซ็บง (1ๅจ+)
โโ film-production-assistant (ๅฝฑ่งๅถไฝ)
7. ๆ่ฝๅฏนๆฏ็ฉ้ต
ๅฏนๆฏๅคไธช็ธไผผๆ่ฝ๏ผๅธฎๅฉ้ๆฉ๏ผ# ๅฏนๆฏๆ็ดข็ฑปๆ่ฝ
python3 scripts/compare_matrix.py tavily-search web-search exa-search่พๅบ:
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโ
โ ๅ่ฝ โ tavily-searchโ web-search โ exa-search โ
โโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโผโโโโโโโโโโโโโโค
โ ๅฎๆถๆ็ดข โ โ
โ โ
โ โ
โ
โ ๅ
ๅฎนๆๅ โ โ
โ โ โ โ
โ
โ ๅ
่ดน้ขๅบฆ โ 1000ๆฌก/ๆ โ ๆ ้ๅถ โ 100ๆฌก/ๆ โ
โ ้่ฆAPI Key โ โ
โ โ
โ โ
โ
โโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโโโโ
8. ่ชๅจๅๆ่ฝๅฎก่ฎก
ๅฎๆๆฃๆฅๆ่ฝๅบ๏ผๅ็ฐๆฝๅจ้ฎ้ข๏ผ# ๆ่ฝๅฎก่ฎก
python3 scripts/audit_skills.py่พๅบ:
๐ ๆ่ฝๅฎก่ฎกๆฅๅ:
โ ๏ธ ๅ็ฐ 3 ไธชๆ่ฝ็ผบๅฐ SKILL.md
โ ๏ธ ๅ็ฐ 2 ไธชๆ่ฝไพ่ตๆชๅฎ่ฃ
๐ก ๅปบ่ฎฎๆดๆฐ: stock-watcher (ๆฐ็ๆฌๅฏ็จ)
9. ๅๆ็จๆณ็ๆๅจ โญๆฐ
ไธบไปปๆๆ่ฝ็ๆ่ถ ๅบๅธธ่ง็จๆณ็ๅๆๅบๆฏ๏ผ# ่ทๅๆ่ฝ็ๅๆ็จๆณ
python3 scripts/creative_usage.py stock-watcher
่พๅบ็คบไพ:
๐ก stock-watcher ๅๆ็จๆณๆๅ๐ฏ ็ฒพ้ๅๆ็จๆณ:
1. ๐ ๆบ่ฝ้่กๅฉๆ
๐ญ ็ปๅAIๅๆ๏ผ่ชๅจ็ญ้ๆฝๅ่ก็ฅจ
ๆญฅ้ชค:
1. ๆน้ๆทปๅ ๅ
ณๆณจ็ๆฟๅ่ก็ฅจ
2. ็ญ้ๆถจๅน
/่ทๅน
ๅผๅธธ็่ก็ฅจ
3. ็จAIๅๆๅบๆฌ้ขๅๆๆฏ้ข
4. ็ๆๆฏๆฅ้่กๆฅๅ
โ
ไปทๅผ: ไปๆๅจ็ๆงๅ็บงไธบๆบ่ฝ้่ก
2. ๐ค ่ชๅจๅไบคๆๆ้
๐ญ ่ฎพ็ฝฎๆกไปถๅ๏ผ่ชๅจ่งฆๅไนฐๅๆ้
ๆญฅ้ชค:
1. ่ฎพ็ฝฎไปทๆ ผ้ข่ญฆ
2. ็ปๅcronๅฎๆถๆฃๆฅ
3. ้่ฟQQ/Telegramๆจ้้็ฅ
โ
ไปทๅผ: ไธๅ้่ฟไบคๆๆถๆบ
3. ๐ ๆ่ต็ปๅๅๆ
๐ญ ็ฎก็ๅคๅช่ก็ฅจ๏ผๅๆๆดไฝๆถ็
โ
ไปทๅผ: ไปๅ่ก็ๆงๅฐ็ปๅ็ฎก็
ๅๆ็จๆณ็น็น๏ผ
ๆฏๆ้ข่ฎพๅๆ็จๆณ็ๆ่ฝ๏ผ
ๅ ถไปๆ่ฝ๏ผ ่ชๅจ็ๆๅบไบๆ่ฟฐ็ๆบ่ฝๅปบ่ฎฎ
Tips
--format json ๅฏไปฅๅฐๅๆ็ปๆๅฏผๅ
ฅๅ
ถไปๅทฅๅ
ท่ฟไธๆญฅๅค็๐ก Examples
ๅๆๅไธชๆ่ฝ
# ๅๆๆๅฎๆ่ฝ
python3 scripts/analyze_skill.py /path/to/skill/SKILL.mdๅๆๅทฒๅฎ่ฃ
็ๆ่ฝ
python3 scripts/analyze_skill.py ~/.openclaw/workspace/skills/stock-watcher/SKILL.md
ๅๆๆๆๅทฒๅฎ่ฃ ๆ่ฝ
# ็ๆๆๆๆ่ฝ็ๅฟซ้ๅ่
python3 scripts/analyze_all.py
๐ Tips & Best Practices
--format json ๅฏไปฅๅฐๅๆ็ปๆๅฏผๅ
ฅๅ
ถไปๅทฅๅ
ท่ฟไธๆญฅๅค็