SkillScope — Skill Decision Engine
When a user needs a skill, don't just search — get a personalized recommendation with quality and safety scoring.
Core Workflow
- 1. User describes a task → call recommend → get best skill + alternatives with reasons
- User wants to install → provide the
install command from the response - User wants details → call detail for full analysis
Base URL
CODEBLOCK0
No API key required (20 req/min, 200 req/day).
Recommend (Primary Tool)
When to use: User asks "find me a skill for X", "is there a tool that can Y", "what's the best skill for Z", or describes any task that a skill could help with.
CODEBLOCK1
With context for better results:
CODEBLOCK2
Parameters:
- -
task (required): natural language task description - INLINECODE2 :
macos / linux / INLINECODE5 - INLINECODE6 :
cn / us (auto-inferred if omitted) - INLINECODE9 :
free / paid / any (default any) - INLINECODE14 :
beginner / intermediate / INLINECODE17 - INLINECODE18 : include LLM-generated reasons (default true, set false for ~250ms response)
Response: recommendation (top pick) + alternatives[], each with skill_id, name, quality, safety, score, reason, install command.
Install
Users can install skills via:
- -
clawhub install <slug> (official ClawHub CLI) - INLINECODE29 (China mirror,
pip install skillscope)
To get installable files via API:
CODEBLOCK3
Search
For keyword-based search (when recommend is not appropriate):
CODEBLOCK4
Skill Detail
Full analysis including security profile, quality scores, dependencies:
CODEBLOCK5
Other Endpoints
| Endpoint | Description |
|---|
| INLINECODE31 | List all 30 categories with counts |
| INLINECODE32 |
Skills in a category (paginated) |
|
GET /leaderboard?sort=downloads | Rankings (downloads/stars/installs) |
|
GET /authors/{handle} | Author profile + their skills |
|
GET /similar/{skill_id} | Similar skills (vector similarity) |
|
GET /starter-kits | Curated skill bundles (30 kits) |
|
GET /articles | Guide articles and top-lists |
Notes
- - Security grades: A (safe) / B (limited access) / C (review needed) / D (risky)
- Quality scores: 0-10
- Skill IDs:
author/slug format (e.g. steipete/weather) - Slugs work too:
weather resolves to INLINECODE41 - Rate limits: anonymous 20/min + 200/day, API key 60/min + 5000/day
- Recommend has separate limits: 5/min, 10/day (anonymous) or 100/day (API key)
SkillScope — 技能决策引擎
当用户需要某项技能时，无需自行搜索——获取个性化推荐，附带质量与安全评分。
核心工作流程
- 1. 用户描述任务 → 调用 recommend → 获取最佳技能及备选方案，附带推荐理由
- 用户想要安装 → 从响应中提供 install 命令
- 用户想要了解详情 → 调用 detail 获取完整分析
基础URL
https://skillscope.cn/api/v1
无需API密钥（每分钟20次请求，每天200次请求）。
推荐（主要工具）
使用场景：用户询问帮我找一项技能来做X、有没有工具可以Y、做Z的最佳技能是什么，或描述任何需要技能协助的任务。
bash
curl -X POST https://skillscope.cn/api/v1/recommend \
-H Content-Type: application/json \
-d {task: 将PDF文档翻译成中文, explain: true}
添加上下文以获得更佳结果：
bash
curl -X POST https://skillscope.cn/api/v1/recommend \
-H Content-Type: application/json \
-d {
task: 将PDF文档翻译成中文,
context: {platform: macos, region: cn, budget: free},
explain: true
}
参数说明：
- - task（必填）：自然语言描述的任务
- context.platform：macos / linux / windows
- context.region：cn / us（未指定时自动推断）
- context.budget：free / paid / any（默认any）
- context.skill_level：beginner / intermediate / advanced
- explain：是否包含LLM生成的推荐理由（默认true，设为false时响应时间约250ms）
响应内容：recommendation（首选推荐）+ alternatives[]，每项包含skill_id、name、quality、safety、score、reason、install命令。
安装
用户可通过以下方式安装技能：
- - clawhub install （官方ClawHub CLI）
- skillscope install （中国镜像，pip install skillscope）
通过API获取可安装文件：
bash
curl https://skillscope.cn/api/v1/install/weather/files
搜索
适用于基于关键词的搜索（当推荐功能不适用时）：
bash
curl https://skillscope.cn/api/v1/search?q=web+scraping
技能详情
完整分析，包括安全配置、质量评分、依赖关系：
bash
curl https://skillscope.cn/api/v1/skills/steipete/weather
其他接口
| 接口 | 描述 |
|---|
| GET /categories | 列出全部30个分类及其数量 |
| GET /categories/{name} |
某分类下的技能（分页） |
| GET /leaderboard?sort=downloads | 排行榜（下载量/星标数/安装量） |
| GET /authors/{handle} | 作者资料及其技能 |
| GET /similar/{skill_id} | 相似技能（向量相似度） |
| GET /starter-kits | 精选技能包（30个工具包） |
| GET /articles | 指南文章和排行榜 |
备注
- - 安全等级：A（安全）/ B（有限访问）/ C（需审查）/ D（有风险）
- 质量评分：0-10分
- 技能ID格式：作者/别名（例如steipete/weather）
- 也可使用别名：weather会自动解析为steipete/weather
- 速率限制：匿名用户每分钟20次+每天200次，API密钥用户每分钟60次+每天5000次
- 推荐功能有独立限制：匿名用户每分钟5次+每天10次，API密钥用户每天100次
