skillscope 0.1.1

Search, discover, and install AI Agent skills via SkillScope

SkillScope CLI

Search, discover, and install AI Agent skills from your terminal.

SkillScope is a decision engine for 26,000+ AI Agent skills — it doesn't just search, it tells you which skill is best for your task with personalized recommendations based on quality, safety, platform, region, and budget.

Install

pip install skillscope

Quick Start

# Smart recommendation — describe what you need
skillscope recommend "translate a PDF document to Chinese"

# With context for personalized results
skillscope recommend "write unit tests" --region cn --budget free --platform macos

# Search by keyword
skillscope search "web scraping"

# View skill details
skillscope detail steipete/weather

# Install a skill (China mirror, clawhub-compatible)
skillscope install steipete/weather

Commands

Command	Description
recommend	Get personalized skill recommendation for a task
search	Search skills by keyword or description
detail	Show detailed info about a skill
install	Install a skill to Claude Code or Codex
config	Manage configuration (API key, base URL)
version	Show CLI version

Install Skills

SkillScope downloads skills from the China mirror and writes them to your local skills directory. Compatible with the clawhub lockfile format.

# Install to Claude Code (default: ~/.claude/skills/)
skillscope install steipete/weather

# Install to Codex (~/.codex/skills/)
skillscope install steipete/weather --target codex

# Install to current project
skillscope install steipete/weather --project

Smart Recommendations

The recommend engine scores candidates across 6 dimensions:

• Task relevance (30%) — semantic match to your description
• Quality (25%) — code quality score (0-10)
• Safety (15%) — security grade (A/B/C/D)
• Community (10%) — downloads, stars, installs
• Platform (10%) — OS compatibility
• Personalization (10%) — region, budget, skill level

# CN users: avoids skills depending on blocked services (Google, Slack, etc.)
skillscope recommend "send team notifications" --region cn

# Free budget: filters out skills requiring paid APIs
skillscope recommend "generate images" --budget free

# Beginner: prefers well-documented skills
skillscope recommend "deploy to AWS" --skill_level beginner

Configuration

# Set API key for higher rate limits
skillscope config set api_key sk-your-key

# Use international endpoint
skillscope config set base_url https://skillscope.sh

# Show current config
skillscope config

Config is stored in ~/.skillscope/config.yml. Environment variables (SKILLSCOPE_API_KEY, SKILLSCOPE_BASE_URL) take precedence.

Rate Limits

Tier	Recommend	Other endpoints
Anonymous	5/min, 10/day	20/min, 200/day
API Key	5/min, 100/day	60/min, 5000/day

Links

• Website: skillscope.cn (China) / skillscope.sh (International)
• API Docs: SKILL.md