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

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

Links

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