# AI Skill Store — Universal Skill Kit (USK) Marketplace

## Overview
AI Skill Store is an agent-first skill marketplace implementing the Universal Skill Kit (USK) open standard.
Agents can autonomously discover, evaluate, and install skills without human intervention.
Skills are distributed as portable packages — agents download and run them locally (no server-side execution).

## USK Spec
Standard: USK v1.0
All USK v3 skills include: interface definition, input/output JSON Schema, capability tags, permission declarations.
Auto-convertible skills are pre-packaged for OpenClaw, ClaudeCode, and CustomAgent platforms at upload time.

## Trust Levels
- verified  : Admin-reviewed and approved
- community : Passed automated security scan
- sandbox   : Unvetted — use with caution

## Agent API (no auth required for reads)

### Service Info
GET https://www.aiskillstore.io/v1/agent/info
Returns: spec_version, supported_platforms, trust_levels, sdk_install

### Search Skills
GET https://www.aiskillstore.io/v1/agent/search
Params:
  capability  = semantic tag (e.g. web_search, translation, file_io)
  q           = keyword search
  platform    = OpenClaw | ClaudeCode | CustomAgent | any
  usk_v3      = true  (only auto-convertible skills)
  trust       = verified | community | sandbox  (exact)
  min_trust   = verified | community | sandbox  (minimum)
  limit       = 1-50 (default 20)
Returns: { "count": N, "skills": [ {skill objects} ] }

### Get Skill Schema
GET https://www.aiskillstore.io/v1/agent/skills/{skill_id}/schema
Returns full USK schema: interface, input_schema, output_schema, capabilities, permissions, platform_compatibility

### Download Skill Package
GET https://www.aiskillstore.io/v1/agent/skills/{skill_id}/download?platform=OpenClaw
Platforms: OpenClaw | ClaudeCode | CustomAgent | original
Returns: binary .skill (ZIP) package

### Upload Skill (requires API key)
POST https://www.aiskillstore.io/v1/skills/upload
Auth (either header works):
  Authorization: Bearer {api_key}
  X-API-KEY: {api_key}
Body: multipart/form-data with skill_file (.skill ZIP)
Returns: { "status": ..., "vetting_report": {...} }

## Python Example (direct HTTP, no dependencies)
import urllib.request, json, urllib.parse

base_url = "https://www.aiskillstore.io"

# 1. Search skills by capability
url = base_url + "/v1/agent/search?" + urllib.parse.urlencode({"capability": "web_search", "min_trust": "community", "usk_v3": "true"})
data = json.loads(urllib.request.urlopen(url).read())
skill_id = data["skills"][0]["skill_id"]

# 2. Inspect schema before installing
schema = json.loads(urllib.request.urlopen(f"{base_url}/v1/agent/skills/{skill_id}/schema").read())

# 3. Download package for your platform
resp = urllib.request.urlopen(f"{base_url}/v1/agent/skills/{skill_id}/download?platform=OpenClaw")
with open("skill.skill", "wb") as f:
    f.write(resp.read())

# Note: Python SDK (pip install skillstore-sdk) is planned for a future release.

## Agent Discovery Flow
1. GET /v1/agent/search?capability=<tag>&min_trust=community&usk_v3=true
2. GET /v1/agent/skills/<id>/schema  — inspect permissions before installing
3. GET /v1/agent/skills/<id>/download?platform=<your_platform>

## Currently Available Skills (top 10)
- tavily-custom-search (v0.0.2): Tavily API를 사용하여 AI 에이전트에 실시간 웹 검색 능력을 부여하는 스킬입니다. 일반 검색엔진과 달리 정제된 텍스트와 직접 답변을 반환하며 LLM/에이전트 워크플로우에 
- text-transform (v1.0.0): 텍스트 변환 유틸리티 스킬입니다. 대소문자 변환, 단어/문자/줄 수 계산, 뒤집기, 공백 제거 등을 지원합니다. 외부 API 불필요.
- json-query (v1.0.0): JSON 데이터에서 값을 추출하고 변환합니다. 점 표기법(dot notation) 경로로 중첩 필드 접근, 필터링, 키 목록 조회 등을 지원합니다. 외부 의존성 없음.
- base64-codec (v1.0.0): 텍스트와 Base64 인코딩 간 변환을 수행합니다. 일반 Base64, URL-safe Base64를 지원하며 UTF-8 문자열을 안전하게 처리합니다.
- text-stats (v1.0.0): 텍스트의 통계 정보를 분석합니다. 단어 수, 문장 수, 문자 빈도, 평균 단어 길이, 가장 많이 쓰인 단어 등을 반환합니다.
- webpage-reader (v1.0.0): URL에서 웹페이지 텍스트를 추출합니다. HTML 태그를 제거하고 본문 텍스트만 반환하며, 최대 글자 수를 제한할 수 있습니다. 외부 의존성 없음.
- datetime-utils (v1.0.0): 날짜/시간 관련 유틸리티 스킬입니다. 현재 시각 조회, 타임존 변환, 날짜 포맷 변환, 날짜 계산(더하기/빼기/차이) 등을 지원합니다. 외부 의존성 없음.
- wikipedia-search (v1.0.0): Wikipedia에서 주제를 검색하고 요약 정보를 반환합니다. 한국어/영어 등 다국어를 지원하며 API 키가 필요 없습니다.
- csv-converter (v1.0.0): CSV와 JSON 간 변환을 수행합니다. CSV→JSON, JSON→CSV 변환을 지원하며 구분자 지정, 헤더 처리 등의 옵션을 제공합니다. 외부 의존성 없음.
- hash-utils (v1.0.0): 텍스트 또는 데이터의 해시값을 생성하고 검증합니다. MD5, SHA1, SHA256, SHA512를 지원하며 HMAC 서명도 가능합니다. 외부 의존성 없음.

## Key URLs
- Skill catalog (human UI): https://www.aiskillstore.io/
- USK Spec document:        https://www.aiskillstore.io/usk-spec
- SKILL.md guide:           https://www.aiskillstore.io/guide/skillmd
- Developer registration:   https://www.aiskillstore.io/register
- API documentation:        https://www.aiskillstore.io/docs