{"id":"03f1d116-600b-4ceb-98aa-3a1932373ce2","shortId":"TER26c","kind":"skill","title":"clarvia-aeo-check","tagline":"Score any MCP server, API, or CLI for agent-readiness using Clarvia AEO (Agent Experience Optimization). Search 15,400+ indexed tools before adding them to your workflow.","description":"# Clarvia AEO Check\n\n## Overview\n\nBefore adding any MCP server, API, or CLI tool to your agent workflow, use Clarvia to score its agent-readiness. Clarvia evaluates 15,400+ AI tools across four AEO dimensions: API accessibility, data structuring, agent compatibility, and trust signals.\n\n## Prerequisites\n\nAdd Clarvia MCP server to your config:\n\n```json\n{\n  \"mcpServers\": {\n    \"clarvia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clarvia-mcp-server\"]\n    }\n  }\n}\n```\n\n## When to Use This Skill\n\n- Use when evaluating a new MCP server before adding it to your config\n- Use when comparing two tools for the same job\n- Use when building an agent that selects tools dynamically\n- Use when you want to find the highest-quality tool in a category\n\n## How It Works\n\n### Step 1: Score a specific tool\n\nAsk Claude to score any tool by URL or name:\n\n```\nScore https://github.com/example/my-mcp-server for agent-readiness\n```\n\nClarvia returns a 0-100 AEO score with breakdown across four dimensions.\n\n### Step 2: Search tools by category\n\n```\nFind the top-rated database MCP servers using Clarvia\n```\n\nReturns ranked results from 15,400+ indexed tools.\n\n### Step 3: Compare tools head-to-head\n\n```\nCompare supabase-mcp vs firebase-mcp using Clarvia\n```\n\nReturns side-by-side score breakdown with a recommendation.\n\n### Step 4: Check leaderboard\n\n```\nShow me the top 10 MCP servers for authentication using Clarvia\n```\n\n## Examples\n\n### Example 1: Evaluate before installing\n\n```\nBefore I add this MCP server to my config, score it:\nhttps://github.com/example/new-tool\n\nUse the clarvia aeo_score tool and tell me if it's agent-ready.\n```\n\n### Example 2: Find best tool in category\n\n```\nI need an MCP server for web scraping. Use Clarvia to find the \ntop-rated options and compare the top 3.\n```\n\n### Example 3: CI/CD quality gate\n\nAdd to your CI pipeline using the GitHub Action:\n\n```yaml\n- uses: clarvia-project/clarvia-action@v1\n  with:\n    url: https://your-api.com\n    fail-under: 70\n```\n\n## AEO Score Interpretation\n\n| Score | Rating | Meaning |\n|-------|--------|---------|\n| 90-100 | Agent Native | Built specifically for agent use |\n| 70-89 | Agent Friendly | Works well, minor gaps |\n| 50-69 | Agent Compatible | Works but needs improvement |\n| 30-49 | Agent Partial | Significant limitations |\n| 0-29 | Not Agent Ready | Avoid for agentic workflows |\n\n## Best Practices\n\n- ✅ Score tools before adding them to long-running agent workflows\n- ✅ Use Clarvia's leaderboard to discover alternatives you haven't considered\n- ✅ Re-check scores periodically — tools improve over time\n- ❌ Don't skip scoring for \"well-known\" tools — even popular tools can score poorly\n- ❌ Don't use tools scoring below 50 in production agent pipelines without understanding the limitations\n\n## Common Pitfalls\n\n- **Problem:** Clarvia returns \"not found\" for a tool\n  **Solution:** Try scanning by URL directly with `aeo_score` — Clarvia will score it on-demand\n\n- **Problem:** Score seems low for a tool I trust\n  **Solution:** Use `get_score_breakdown` to see which dimensions are weak and decide if they matter for your use case\n\n## Related Skills\n\n- `@mcp-builder` - Build a new MCP server that scores well on AEO\n- `@agent-evaluation` - Broader agent quality evaluation framework\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["clarvia","aeo","check","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-clarvia-aeo-check","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/clarvia-aeo-check","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34882 github stars · SKILL.md body (3,581 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-24T12:50:45.621Z","embedding":null,"createdAt":"2026-04-18T21:34:17.152Z","updatedAt":"2026-04-24T12:50:45.621Z","lastSeenAt":"2026-04-24T12:50:45.621Z","tsv":"'-100':177,351 '-29':382 '-49':376 '-69':368 '-89':360 '/clarvia-action':335 '/example/my-mcp-server':168 '/example/new-tool':271 '0':176,381 '1':150,254 '10':245 '15':23,60,205 '2':186,288 '3':210,315,317 '30':375 '4':238 '400':24,61,206 '50':367,444 '70':343,359 '90':350 'access':69 'across':64,182 'action':329 'ad':28,38,109,395 'add':78,260,321 'aeo':3,18,34,66,178,275,344,470,522 'agent':14,19,48,56,72,127,171,285,352,357,361,369,377,384,388,401,447,524,527 'agent-evalu':523 'agent-readi':13,55,170,284 'ai':62 'altern':409 'api':9,42,68 'arg':90 'ask':155,564 'authent':249 'avoid':386 'best':290,390 'boundari':572 'breakdown':181,233,492 'broader':526 'build':125,513 'builder':512 'built':354 'case':507 'categori':145,190,293 'check':4,35,239,416 'ci':324 'ci/cd':318 'clarif':566 'clarvia':2,17,33,51,58,79,87,93,173,200,226,251,274,303,333,404,456,472 'clarvia-aeo-check':1 'clarvia-mcp-serv':92 'clarvia-project':332 'claud':156 'clear':539 'cli':11,44 'command':88 'common':453 'compar':116,211,217,312 'compat':73,370 'config':84,113,266 'consid':413 'criteria':575 'data':70 'databas':196 'decid':500 'demand':478 'describ':543 'dimens':67,184,496 'direct':468 'discov':408 'dynam':131 'environ':555 'environment-specif':554 'evalu':59,103,255,525,529 'even':432 'exampl':252,253,287,316 'experi':20 'expert':560 'fail':341 'fail-und':340 'find':137,191,289,305 'firebas':223 'firebase-mcp':222 'found':459 'four':65,183 'framework':530 'friend':362 'gap':366 'gate':320 'get':490 'github':328 'github.com':167,270 'github.com/example/my-mcp-server':166 'github.com/example/new-tool':269 'haven':411 'head':214,216 'head-to-head':213 'highest':140 'highest-qu':139 'improv':374,420 'index':25,207 'input':569 'instal':257 'interpret':346 'job':122 'json':85 'known':430 'leaderboard':240,406 'limit':380,452,531 'long':399 'long-run':398 'low':482 'match':540 'matter':503 'mcp':7,40,80,94,106,197,220,224,246,262,297,511,516 'mcp-builder':510 'mcpserver':86 'mean':349 'minor':365 'miss':577 'name':164 'nativ':353 'need':295,373 'new':105,515 'npx':89 'on-demand':476 'optim':21 'option':310 'output':549 'overview':36 'partial':378 'period':418 'permiss':570 'pipelin':325,448 'pitfal':454 'poor':437 'popular':433 'practic':391 'prerequisit':77 'problem':455,479 'product':446 'project':334 'qualiti':141,319,528 'rank':202 'rate':195,309,348 're':415 're-check':414 'readi':15,57,172,286,385 'recommend':236 'relat':508 'requir':568 'result':203 'return':174,201,227,457 'review':561 'run':400 'safeti':571 'scan':465 'scope':542 'score':5,53,151,158,165,179,232,267,276,345,347,392,417,426,436,442,471,474,480,491,519 'scrape':301 'search':22,187 'see':494 'seem':481 'select':129 'server':8,41,81,95,107,198,247,263,298,517 'show':241 'side':229,231 'side-by-sid':228 'signal':76 'signific':379 'skill':100,509,534 'skill-clarvia-aeo-check' 'skip':425 'solut':463,488 'source-sickn33' 'specif':153,355,556 'step':149,185,209,237 'stop':562 'structur':71 'substitut':552 'success':574 'supabas':219 'supabase-mcp':218 'task':538 'tell':279 'test':558 'time':422 'tool':26,45,63,118,130,142,154,160,188,208,212,277,291,393,419,431,434,441,462,485 'top':194,244,308,314 'top-rat':193,307 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':547 'tri':464 'trust':75,487 'two':117 'understand':450 'url':162,338,467 'use':16,50,98,101,114,123,132,199,225,250,272,302,326,331,358,403,440,489,506,532 'v1':336 'valid':557 'vs':221 'want':135 'weak':498 'web':300 'well':364,429,520 'well-known':428 'without':449 'work':148,363,371 'workflow':32,49,389,402 'y':91 'yaml':330 'your-api.com':339","prices":[{"id":"16e6ecb6-1ee7-417f-a046-cc619875f00c","listingId":"03f1d116-600b-4ceb-98aa-3a1932373ce2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:34:17.152Z"}],"sources":[{"listingId":"03f1d116-600b-4ceb-98aa-3a1932373ce2","source":"github","sourceId":"sickn33/antigravity-awesome-skills/clarvia-aeo-check","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/clarvia-aeo-check","isPrimary":false,"firstSeenAt":"2026-04-18T21:34:17.152Z","lastSeenAt":"2026-04-24T12:50:45.621Z"}],"details":{"listingId":"03f1d116-600b-4ceb-98aa-3a1932373ce2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"clarvia-aeo-check","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34882,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"8dd33a42657edf0d68dfa65a2dbb960acd5d366a","skill_md_path":"skills/clarvia-aeo-check/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/clarvia-aeo-check"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"clarvia-aeo-check","description":"Score any MCP server, API, or CLI for agent-readiness using Clarvia AEO (Agent Experience Optimization). Search 15,400+ indexed tools before adding them to your workflow."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/clarvia-aeo-check"},"updatedAt":"2026-04-24T12:50:45.621Z"}}