Youtube video scorer

AI-powered YouTube video scoring. Scores videos 1-10 based on your learning goals and persona. Use when the user wants to evaluate YouTube videos, check their scored feed, manage tracked channels, or check API usage. Get AI summaries, alignment analysis, and a curated video feed. Keywords: YouTube, video, score, persona, feed, summary, AI, learning, channels. Requires a WorthClip API key from https://worthclip.com/developers.

Security Scan

The skill's files, runtime instructions, and required credential (WORTHCLIP_API_KEY) are consistent with its stated purpose of calling the WorthClip API to score and list YouTube videos.

Purpose & Capability

The name/description require only an API key and the ability to call WorthClip endpoints; the scripts use curl/jq to talk to the documented Convex backend (greedy-mallard-11.convex.site). No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md limits runtime actions to running the provided shell scripts which call WorthClip API endpoints. The scripts only read WORTHCLIP_API_KEY (declared) and do not access other files, system state, or external endpoints beyond the stated base URL.

Install Mechanism

There is no install spec; this is instruction/script-based and uses existing system tools (curl, jq). Nothing is downloaded or written to disk by an installer.

Credentials

Only one environment variable is required (WORTHCLIP_API_KEY), which is appropriate for a service-backed API skill. No additional secrets or unrelated variables are requested.

Persistence & Privilege

The skill is not always-enabled and model invocation is disabled (disable-model-invocation: true), reducing autonomous risk. The skill does not modify other skills or system configs.

Assessment

This skill is coherent and only needs your WorthClip API key and curl/jq to operate. Before installing: (1) Verify you trust WorthClip and that the base URL (https://greedy-mallard-11.convex.site) is the service deployment you expect (WorthClip documents that domain); (2) Keep your WORTHCLIP_API_KEY secret and only provide keys with appropriate scopes/limits; (3) Note that disable-model-invocation is set, so the model won't call the skill autonomously — you must invoke it; (4) If you ever suspect misuse, revoke/rotate the API key in your WorthClip dashboard.

WorthClip - YouTube Video Scoring

Score YouTube videos 1-10 based on your personalized learning goals. Get AI-powered summaries, alignment analysis, and a curated feed.

Setup

1. Sign up at https://worthclip.com
2. Go to Settings > API Keys
3. Generate an API key
4. Set it: export WORTHCLIP_API_KEY="wc_your_key_here"

Commands

Score a video

Scores a YouTube video against the user's persona and goals. Handles async scoring automatically with polling.

bash {baseDir}/scripts/score.sh "VIDEO_ID"

The script submits the video for scoring, polls for completion (up to 60 seconds), and returns the completed score JSON. If the video was already scored, it returns the existing score immediately.

Get your feed

Returns scored videos sorted by relevance, with optional filters.

bash {baseDir}/scripts/feed.sh [--min-score N] [--verdict VERDICT] [--limit N] [--cursor N]

Options:

• --min-score N - Only return videos scored N or above (1-10)
• --verdict VERDICT - Filter by verdict (e.g., "watch", "skip")
• --limit N - Number of results per page
• --cursor N - Pagination cursor from previous response

Check usage

Shows current billing period usage stats and limits.

bash {baseDir}/scripts/usage.sh

API Reference

Base URL: https://greedy-mallard-11.convex.site/api/v1

The API is hosted on Convex (convex.site), WorthClip's serverless backend. The domain greedy-mallard-11.convex.site is WorthClip's production Convex deployment. You can verify this by visiting https://worthclip.com/developers.

All requests (except /health) require Authorization: Bearer YOUR_API_KEY header.

Endpoint	Method	Description
/health	GET	Health check (no auth required)
/score	POST	Score a video (async, returns 202 with jobId)
/score/:jobId	GET	Poll scoring job status
/videos/:ytId/summary	GET	Get video summary (summarization)
/videos/:ytId	GET	Get video detail with full score
/feed	GET	Paginated scored feed with filters
/channels	GET	List tracked channels
/channels/lookup	POST	Lookup channel by YouTube URL
/channels/track	POST	Track a new channel
/persona	GET	Get current persona and goals
/persona	PUT	Update persona description
/goals	PUT	Update learning goals
/usage	GET	Current billing period usage stats

Rate Limits

• General: 60 requests/minute (all endpoints)
• Scoring: 20 requests/minute (POST /score and GET /score/:jobId)

Response headers:

• X-RateLimit-Limit - Maximum requests per window
• X-RateLimit-Remaining - Requests remaining in current window
• Retry-After - Seconds to wait before retrying (only on 429 responses)

Error Format

All errors return a consistent JSON structure with an appropriate HTTP status code:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description of the error"
  }
}

Common error codes:

• UNAUTHORIZED (401) - Missing or invalid API key
• RATE_LIMITED (429) - Too many requests
• NOT_FOUND (404) - Resource not found
• VALIDATION_ERROR (400) - Invalid request parameters
• INTERNAL_ERROR (500) - Server error

Base URL

https://greedy-mallard-11.convex.site/api/v1