Metadata-Version: 2.4
Name: skillscope
Version: 0.1.1
Summary: Search, discover, and install AI Agent skills via SkillScope
Author-email: SkillScope <hi@skillscope.cn>
License-Expression: MIT
Project-URL: Homepage, https://skillscope.cn
Project-URL: Repository, https://github.com/smilelight/skillscope
Project-URL: Documentation, https://skillscope.cn/guides/top-openclaw-tools
Keywords: ai,agent,skill,claude,codex,clawhub
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Requires-Dist: fire>=0.5
Requires-Dist: pyyaml>=6.0

# 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

```bash
pip install skillscope
```

## Quick Start

```bash
# 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.

```bash
# 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

```bash
# 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

```bash
# 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](https://skillscope.cn) (China) / [skillscope.sh](https://skillscope.sh) (International)
- API Docs: [SKILL.md](https://github.com/smilelight/skillscope/blob/master/skills/skillscope/SKILL.md)
