Skill SEO Optimizer 🔍
Get your ClawHub skill found. This skill analyzes your SKILL.md and optimizes it for ClawHub's vector search, explore rankings, and agent auto-discovery.
Quick Start
CODEBLOCK0
The agent will audit your skill and output an optimized version.
How ClawHub Discovery Works
Skills are found through three channels. Each needs different optimization:
Channel 1: clawhub search (Vector Search) — 70% of discovery
ClawHub uses semantic vector search on the description field in YAML frontmatter. This is NOT keyword matching — it's meaning matching.
What gets indexed: Only the description field.
What does NOT get indexed: The markdown body, scripts, references, filenames.
Optimization rules:
- 1. Cover synonyms and variations
CODEBLOCK1
- 2. Include trigger phrases — Write the exact phrases users say:
- "how do I..."
- "is there a skill that..."
- "I want to..."
- "can my agent..."
- 3. Name the problem, not just the solution
CODEBLOCK2
- 4. Optimal description length: 150-300 words. Too short = misses search terms. Too long = dilutes relevance.
Channel 2: clawhub explore (Rankings) — 20% of discovery
Users browse by: newest, trending, downloads, rating.
Optimization rules:
- 1. Update frequently — Each version bump puts you in INLINECODE8
- Ship v0.1.0, then v0.1.1 next week, v0.1.2 the week after
- Even small improvements (typo fix, example added) justify a patch
- 2. Version strategically — Big features = minor bump (0.2.0), polish = patch (0.1.1)
- 3. Seed initial downloads — Install your own skill across your agents to get off zero
Channel 3: Agent Auto-Discovery (find-skills) — 10% of discovery
Some agents have find-skills installed, which searches ClawHub when users ask for capabilities.
Optimization rules:
- - Description must match natural language questions
- Include the phrase patterns from Channel 1
Audit Checklist
Run this against any SKILL.md:
CODEBLOCK3
Workflow: Optimize an Existing Skill
Step 1: Extract current state
CODEBLOCK4
Step 2: Competitor analysis
CODEBLOCK5
Step 3: Generate optimized description
Formula:
CODEBLOCK6
Step 4: Publish and verify
CODEBLOCK7
Step 5: Track and iterate
- - Check ranking weekly for your top 5 keywords
- If dropping, update description and bump version
- Monitor competitors for new entrants
Anti-Patterns
- - ❌ Keyword stuffing with irrelevant terms — Vector search penalizes semantic mismatch
- ❌ Description longer than 400 words — Dilutes relevance signal
- ❌ Generic descriptions — "A useful skill for various tasks" matches nothing
- ❌ Never updating — Falls off newest, loses freshness signal
- ❌ Ignoring competitors — If 3 skills match the same query, differentiation matters
技能SEO优化器 🔍
让你的ClawHub技能更容易被发现。该技能会分析你的SKILL.md文件，并针对ClawHub的向量搜索、探索排名和智能体自动发现进行优化。
快速开始
为ClawHub优化我的技能：[技能/SKILL.md路径]
智能体会审核你的技能并输出优化版本。
ClawHub发现机制的工作原理
技能通过三个渠道被发现。每个渠道需要不同的优化策略：
渠道1：clawhub search（向量搜索）— 占发现的70%
ClawHub使用语义向量搜索来匹配YAML前置元数据中的description字段。这不是关键词匹配——而是语义匹配。
被索引的内容： 仅description字段。
不被索引的内容： Markdown正文、脚本、引用、文件名。
优化规则：
- 1. 覆盖同义词和变体
yaml
# ❌ 错误：描述过于狭窄
description: 从Reddit数据生成每周报告。
# ✅ 正确：覆盖用户实际搜索方式
description: 从Reddit、Twitter/X和YouTube生成每周趋势报告。
社交媒体监控、内容研究、竞品分析、趋势追踪。当用户要求监控趋势、
每周报告、什么在流行、社交聆听、社交媒体内容创意、
追踪竞争对手、发现热门话题时使用。
- 2. 包含触发短语 — 写出用户常说的精确短语：
- 我如何...
- 有没有一个技能可以...
- 我想要...
- 我的智能体能否...
- 3. 描述问题，而不仅仅是解决方案
yaml
# ❌ 仅描述解决方案
description: 智能体日志记录和情绪追踪。
# ✅ 问题+解决方案
description: 减少重复性AI输出和模式僵化。智能体日志记录、情绪追踪、
创意刷新。解决智能体倦怠、回复无聊、缺乏个性等问题。
- 4. 最佳描述长度： 150-300字。太短=遗漏搜索词。太长=稀释相关性。
渠道2：clawhub explore（排名）— 占发现的20%
用户通过以下方式浏览：最新、热门、下载量、评分。
优化规则：
- 1. 频繁更新 — 每次版本升级都会让你出现在最新列表中
- 发布v0.1.0，下周发布v0.1.1，再下周发布v0.1.2
- 即使是小改进（修正错别字、添加示例）也值得发布补丁
- 2. 策略性版本管理 — 大功能=次版本升级（0.2.0），优化=补丁版本（0.1.1）
- 3. 种子初始下载 — 在你的智能体中安装自己的技能，从零开始积累下载量
渠道3：智能体自动发现（find-skills）— 占发现的10%
部分智能体安装了find-skills功能，当用户询问特定能力时会搜索ClawHub。
优化规则：
- - 描述必须匹配自然语言问题
- 包含渠道1中的短语模式
审核清单
对任何SKILL.md文件执行以下检查：
markdown
描述审核
- - [ ] 长度：150-300字？
- [ ] 包含10个以上同义词/变体短语？
- [ ] 包含5个以上触发短语（用户自然语言）？
- [ ] 描述了问题，而不仅仅是解决方案？
- [ ] 提及目标受众/使用场景？
- [ ] 包含负面触发词（不显示、找不到、无结果）？
竞争分析审核
- - [ ] 在ClawHub上搜索你的前5个关键词——你的排名如何？
- [ ] 识别出前3个竞争技能？
- [ ] 描述与竞争对手有明显区分？
新鲜度审核
- - [ ] 最近2周内更新过？
- [ ] 维护了更新日志或版本历史？
- [ ] 有未来3个补丁版本的发布计划？
工作流程：优化现有技能
步骤1：提取当前状态
bash
读取当前描述
head -20 路径/到/SKILL.md
检查当前搜索排名
clawhub search 你的主要关键词 --limit 10
clawhub search 备选关键词 --limit 10
步骤2：竞争对手分析
bash
查找竞争技能
clawhub search 你的领域 --limit 10
检查顶级结果
clawhub inspect 竞争对手技能名称
步骤3：生成优化描述
公式：
[1句话描述核心能力]
[3-4个具体功能/模块]
[5个以上自然语言触发短语]
[目标受众]
[与竞争对手的差异化]
[相关代币/资源成本]
步骤4：发布并验证
bash
clawhub publish ./你的技能 --version X.Y.Z
等待2-3分钟索引完成，然后验证
clawhub search 你的关键词1 --limit 5
clawhub search 你的关键词2 --limit 5
clawhub search 自然语言问题 --limit 5
步骤5：追踪和迭代
- - 每周检查前5个关键词的排名
- 如果排名下降，更新描述并升级版本
- 监控新进入的竞争对手
反模式
- - ❌ 填充不相关的关键词 — 向量搜索会惩罚语义不匹配
- ❌ 描述超过400字 — 稀释相关性信号
- ❌ 通用描述 — 一个适用于各种任务的有用技能无法匹配任何内容
- ❌ 从不更新 — 从最新列表中消失，失去新鲜度信号
- ❌ 忽视竞争对手 — 如果3个技能匹配同一个查询，差异化至关重要
