{"components":{"schemas":{"ProblemDetails":{"description":"RFC 7807 Problem Details with machine-readable error_code + legacy message field.","properties":{"detail":{"description":"\uc0ac\ub78c\uc774 \uc77d\ub294 \uc0c1\uc138 \uc124\uba85","type":"string"},"error_code":{"description":"\uae30\uacc4 \ud310\ub3c5\uc6a9 \uc5d0\ub7ec \ucf54\ub4dc. \uc608: AUTH_FAILED / FILE_MISSING / SKILL_MD_MISSING / VETTING_JOB_NOT_FOUND / CONTENT_TOO_LARGE \ub4f1","enum":["AUTH_REQUIRED","AUTH_FAILED","EMAIL_NOT_VERIFIED","FORBIDDEN_NOT_OWNER","FILE_MISSING","FILE_INVALID_TYPE","FILE_TOO_LARGE","JSON_PARSE_FAILED","JSON_BODY_INVALID","CONTENT_TYPE_INVALID","SKILL_MD_MISSING","SKILL_MD_TOO_LARGE","CONTENT_INVALID_STRUCTURE","CONTENT_TOO_MANY_FILES","CONTENT_TOO_LARGE","REQUIREMENTS_INVALID","FILE_NAME_INVALID","FILE_NAME_RESERVED","FILE_CONTENT_INVALID","BASE64_DECODE_FAILED","ZIP_BUILD_FAILED","UPLOAD_FAILED","VETTING_JOB_NOT_FOUND","VERSION_NOT_FOUND","SKILL_NOT_FOUND","RATE_LIMIT_EXCEEDED","VETTING_REJECTED","VETTING_SECURITY_PATTERN","AGENT_AUTHOR_REQUIRED","AGENT_AUTHOR_INVALID","SKILL_NAME_TAKEN","SKILL_NAME_DRAFT_COLLISION","CLAIM_TOKEN_INVALID","CLAIM_TOKEN_EXPIRED","CLAIM_TOKEN_MISMATCH","CLAIM_ALREADY_COMPLETED","CLAIM_EMAIL_REQUIRED","CLAIM_VERIFY_FAILED","CLAIM_VERIFY_EXPIRED","REVIEW_NOT_ALLOWED_ON_DRAFT","SKILL_NAME_TOO_LONG","SKILL_MD_INVALID","VERSION_DUPLICATE","AGENT_SECRET_REQUIRED","AGENT_SECRET_INVALID","CONTACT_EMAIL_INVALID","AGENT_IDENTITY_NOT_FOUND","AGENT_TOKEN_EXPIRED","AGENT_TOKEN_CONSUMED","NOT_FOUND","FORBIDDEN","METHOD_NOT_ALLOWED","INTERNAL_SERVER_ERROR","HTTP_ERROR","INVALID_INPUT","INVALID_ENCODING"],"type":"string"},"findings":{"description":"\uc120\ud0dd. \uad6c\uc870\ud654\ub41c \uac80\uc218/\uac80\uc99d \uc2e4\ud328 \ud56d\ubaa9\ub4e4","items":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"severity":{"type":"string"}},"type":"object"},"type":"array"},"message":{"description":"\ub808\uac70\uc2dc \ud638\ud658. detail \uacfc \ub3d9\uc77c \ub0b4\uc6a9","type":"string"},"status":{"description":"HTTP \uc0c1\ud0dc \ucf54\ub4dc","type":"integer"},"status_legacy":{"description":"\ub808\uac70\uc2dc \ud638\ud658. \uae30\uc874 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 status:'error' \ub85c \ubd84\uae30\ud558\ub358 \uacbd\ub85c \uc720\uc9c0","enum":["error"],"type":"string"},"title":{"description":"\uc0ac\ub78c\uc774 \uc77d\ub294 \uc9e7\uc740 \uc81c\ubaa9","type":"string"},"type":{"description":"\uc5d0\ub7ec \uce74\ud14c\uace0\ub9ac URI. \uc608: https://aiskillstore.io/errors/AUTH_FAILED","format":"uri","type":"string"}},"required":["type","title","status","detail","error_code"],"type":"object"}},"securitySchemes":{"AdminKeyAuth":{"in":"header","name":"X-ADMIN-API-KEY","type":"apiKey"},"ApiKeyAuth":{"in":"header","name":"X-API-KEY","type":"apiKey"},"BearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"AI \uc5d0\uc774\uc804\ud2b8\uc6a9 \uc2a4\ud0ac \ub9c8\ucf13\ud50c\ub808\uc774\uc2a4 REST API.\n\n**\uc778\uc99d**\n- \uc2a4\ud0ac \uc5c5\ub85c\ub4dc/\uc218\uc815: `X-API-KEY` \ud5e4\ub354 \ub610\ub294 `Authorization: Bearer <api_key>`\n- \uad00\ub9ac\uc790 \uae30\ub2a5: `X-ADMIN-API-KEY` \ud5e4\ub354\n- \uc870\ud68c/\ub2e4\uc6b4\ub85c\ub4dc: \uc778\uc99d \ubd88\ud544\uc694","title":"AI Skill Store API","version":"1.0.0"},"openapi":"3.0.0","paths":{"/feed/new-skills.json":{"get":{"responses":{"200":{"description":"JSON Feed \u2014 \ucd5c\uc2e0 \uc2b9\uc778 \uc2a4\ud0ac 30\uac1c"}},"summary":"JSON Feed 1.1 \u2014 \uc2e0\uaddc \uc2a4\ud0ac \ud53c\ub4dc (5\ubd84 \uce90\uc2dc)","tags":["feeds"]}},"/feed/new-skills.rss":{"get":{"responses":{"200":{"description":"RSS XML \u2014 \ucd5c\uc2e0 \uc2b9\uc778 \uc2a4\ud0ac 30\uac1c"}},"summary":"RSS 2.0 \u2014 \uc2e0\uaddc \uc2a4\ud0ac \ud53c\ub4dc","tags":["feeds"]}},"/v1/admin/owners":{"get":{"responses":{"200":{"description":"\uc0ac\uc6a9\uc790 \ubaa9\ub85d"},"401":{"description":"\uad8c\ud55c \uc5c6\uc74c"}},"security":[{"AdminKeyAuth":[]}],"summary":"\uc804\uccb4 \uc0ac\uc6a9\uc790 \ubaa9\ub85d \uc870\ud68c","tags":["admin"]}},"/v1/admin/owners/{owner_id}/active":{"post":{"parameters":[{"in":"path","name":"owner_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"is_active":{"type":"boolean"}},"type":"object"}}}},"responses":{"200":{"description":"\ucc98\ub9ac \uc644\ub8cc"}},"security":[{"AdminKeyAuth":[]}],"summary":"\uc0ac\uc6a9\uc790 \ud65c\uc131/\ube44\ud65c\uc131 \uc124\uc815","tags":["admin"]}},"/v1/agent-authors/{agent_name}/identity-stats":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8 \ub2e8\uc704 identity \uae30\ubc18 \ud1b5\uacc4. D4 (Layer 4) \u2014 \uc5d0\uc774\uc804\ud2b8 \ube4c\ub354\uac00 \uc790\uae30 \uc5d0\uc774\uc804\ud2b8\uc758 claim_success_rate \ub97c \uacf5\uac1c \uc9c0\ud45c\ub85c \ud65c\uc6a9 \uac00\ub2a5.","parameters":[{"in":"path","name":"agent_name","required":true,"schema":{"maxLength":120,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"stats":{"properties":{"agent_author":{"type":"string"},"claim_success_rate":{"description":"total_claimed / total_uploads (0.0~1.0)","type":"number"},"claimed":{"type":"boolean"},"contact_email_verified":{"type":"boolean"},"has_contact_email":{"type":"boolean"},"total_claimed":{"type":"integer"},"total_expired":{"type":"integer"},"total_uploads":{"type":"integer"}},"type":"object"},"status":{"type":"string"}},"type":"object"}}},"description":"\ud1b5\uacc4"},"404":{"description":"Agent identity \uc5c6\uc74c \u2014 AGENT_IDENTITY_NOT_FOUND"}},"summary":"Agent Identity \ud1b5\uacc4 (claim \uc131\uacf5\ub960, 2026-04-23)","tags":["agent"]}},"/v1/agent-authors/{agent_name}/stats":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8 \ube4c\ub354\uac00 '\uc6b0\ub9ac \uc5d0\uc774\uc804\ud2b8\uac00 Skill Store\uc5d0 N\uac1c \uae30\uc5ec\ud588\ub2e4' \ub97c \uc678\ubd80\uc5d0 \uacf5\uac1c\ud558\uae30 \uc704\ud55c \uc9c0\ud45c. skills_count, total_downloads, downloads_7d, avg_rating, top_categories \ubc18\ud658.","parameters":[{"in":"path","name":"agent_name","required":true,"schema":{"maxLength":80,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"stats":{"type":"object"},"status":{"type":"string"}},"type":"object"}}},"description":"\ud1b5\uacc4 \uac1d\uccb4"}},"summary":"Agent Attribution \u2014 \ud2b9\uc815 \uc5d0\uc774\uc804\ud2b8\uac00 \uc5c5\ub85c\ub354\ub85c \uae30\ub85d\ub41c \uc2a4\ud0ac\uc758 \uc9d1\uacc4 \ud1b5\uacc4 (2026-04-19)","tags":["agent"]}},"/v1/agent/info":{"get":{"description":"\uc9c0\uc6d0 \ud50c\ub7ab\ud3fc, trust \ub808\ubca8, \uc5d4\ub4dc\ud3ec\uc778\ud2b8 \ubaa9\ub85d, SDK \uc815\ubcf4 \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","responses":{"200":{"description":"\uc11c\ube44\uc2a4 \uc815\ubcf4 JSON"}},"summary":"\uc11c\ube44\uc2a4 \uba54\ud0c0\ub370\uc774\ud130 (\uc5d0\uc774\uc804\ud2b8 \uc9c4\uc785\uc810)","tags":["agent"]}},"/v1/agent/search":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8\uac00 \ud544\uc694\ud55c \uae30\ub2a5(capability)\uc744 \uac80\uc0c9. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"description":"\ucc3e\uc73c\ub824\ub294 \uae30\ub2a5 (\uc608: web_search, hash_generation)","in":"query","name":"capability","schema":{"type":"string"}},{"description":"\ud0a4\uc6cc\ub4dc \uac80\uc0c9 (\uc774\ub984/\uc124\uba85)","in":"query","name":"q","schema":{"type":"string"}},{"description":"\ud50c\ub7ab\ud3fc \ud544\ud130","in":"query","name":"platform","schema":{"enum":["OpenClaw","ClaudeCode","ClaudeCodeAgentSkill","CustomAgent","Cursor","GeminiCLI","CodexCLI"],"type":"string"}},{"description":"USK v3 \uc804\uc6a9 \ud544\ud130","in":"query","name":"usk_v3","schema":{"type":"boolean"}},{"description":"\uc815\ud655\ud55c trust \ub808\ubca8","in":"query","name":"trust","schema":{"enum":["verified","community","sandbox"],"type":"string"}},{"description":"\ucd5c\uc18c trust \ub808\ubca8 (\uacc4\uce35 \uc801\uc6a9)","in":"query","name":"min_trust","schema":{"enum":["verified","community","sandbox"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"\ub9e4\uce6d \uc2a4\ud0ac \ubaa9\ub85d (capabilities, schema \ud3ec\ud568)"}},"summary":"capability \uae30\ubc18 \uc2a4\ud0ac \uac80\uc0c9","tags":["agent"]}},"/v1/agent/skills/{skill_id}/download":{"get":{"description":"platform \ud30c\ub77c\ubbf8\ud130\uc5d0 \ub530\ub77c \uc801\ud569\ud55c .skill \ud30c\uc77c \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"platform","schema":{"default":"OpenClaw","enum":["OpenClaw","ClaudeCode","ClaudeCodeAgentSkill","CustomAgent","Cursor","GeminiCLI","CodexCLI"],"type":"string"}}],"responses":{"200":{"description":".skill \ud30c\uc77c (ZIP)"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\ud50c\ub7ab\ud3fc\ubcc4 \uc2a4\ud0ac \ud328\ud0a4\uc9c0 \ub2e4\uc6b4\ub85c\ub4dc","tags":["agent"]}},"/v1/agent/skills/{skill_id}/schema":{"get":{"description":"input/output schema, capabilities, permissions, \ub2e4\uc6b4\ub85c\ub4dc URL \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\uc2a4\ud0ac \uc2a4\ud0a4\ub9c8 (interface, input_schema, output_schema, capabilities)"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \uc804\uccb4 \uc2a4\ud0a4\ub9c8 \uc870\ud68c","tags":["agent"]}},"/v1/agent/skills/{skill_id}/similar":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":10,"maximum":30,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"\uc720\uc0ac \uc2a4\ud0ac \ubaa9\ub85d"},"404":{"description":"Skill not found (RFC 7807 Problem Details)"}},"summary":"\uc720\uc0ac \uc2a4\ud0ac \ucd94\ucc9c \u2014 \uce74\ud14c\uace0\ub9ac/\ud0dc\uadf8/capability \uacb9\uce68 \uc2a4\ucf54\uc5b4\ub9c1","tags":["agent"]}},"/v1/analytics/events":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"event_type":{"enum":["install","run","error","uninstall","view"],"type":"string"},"platform":{"type":"string"},"skill_id":{"type":"string"}},"required":["skill_id","event_type"],"type":"object"}}}},"responses":{"200":{"description":"\uae30\ub85d \uc644\ub8cc"}},"summary":"\uc2a4\ud0ac \uc0ac\uc6a9 \uc774\ubca4\ud2b8 \uae30\ub85d","tags":["analytics"]}},"/v1/demand/most-wanted":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8/\uc0ac\uc6a9\uc790\uac00 \uac80\uc0c9\ud588\uc9c0\ub9cc \uacb0\uacfc 0\uac74\uc774\uc5c8\ub358 \ucffc\ub9ac\ub97c \uc9d1\uacc4 \ubc18\ud658. **\ud544\ud130 \uae30\uc900\uc740 `last_zero_seen`** \u2014 \uc2a4\ud0ac\uc774 \uc5c5\ub85c\ub4dc\ub418\uc5b4 \ud574\ub2f9 \ucffc\ub9ac\uac00 \ub9e4\uce58\ub418\uae30 \uc2dc\uc791\ud558\uba74 `last_zero_seen` \uc774 \uac31\uc2e0\ub418\uc9c0 \uc54a\uc544 `days` \uc708\ub3c4\uc6b0\uc5d0\uc11c \uc790\uc5f0\uc2a4\ub7fd\uac8c \ud398\uc774\uc9c0 \uc544\uc6c3 (\uba85\uc2dc\uc801 \ud574\uacb0 \ud50c\ub798\uadf8 \uc5c6\uc774 \uc790\ub3d9 \uc18c\uba78). \ube4c\ub354/\uac1c\ubc1c\uc790\uac00 '\ub9cc\ub4e4\uba74 \uc989\uc2dc \uc218\uc694 \uc788\uc74c' \uc815\ubcf4\ub97c \uc5bb\uc5b4 \uacf5\uae09\uc790\ub85c \uc804\ud658\ud560 \uc218 \uc788\ub3c4\ub85d \ud568. 5\ubd84 \uce90\uc2dc.","parameters":[{"description":"\ucd5c\uadfc N\uc77c \uc774\ub0b4 0\uac74 \uacb0\uacfc\uac00 \ub2e4\uc2dc \ubc1c\uc0dd\ud55c \ucffc\ub9ac\ub9cc (last_zero_seen \uae30\uc900)","in":"query","name":"days","schema":{"default":30,"maximum":365,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":100,"type":"integer"}},{"in":"query","name":"type","schema":{"default":"all","enum":["keyword","capability","all"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"days":{"type":"integer"},"items":{"items":{"properties":{"first_seen":{"type":"string"},"last_seen":{"description":"\uac00\uc7a5 \ucd5c\uadfc \ud574\ub2f9 \ucffc\ub9ac \uac80\uc0c9 \uc2dc\uac01 (\ub9e4\uce58 \uc5ec\ubd80 \ubb34\uad00)","type":"string"},"last_zero_seen":{"description":"\uac00\uc7a5 \ucd5c\uadfc **0\uac74** \uacb0\uacfc \ubc1c\uc0dd \uc2dc\uac01. \ud544\ud130 \uc708\ub3c4\uc6b0\uc758 \uae30\uc900.","type":"string"},"query":{"description":"\uc815\uaddc\ud654\ub41c \uc18c\ubb38\uc790 \ucffc\ub9ac \ubb38\uc790\uc5f4","type":"string"},"query_type":{"enum":["keyword","capability"],"type":"string"},"total_count":{"description":"\uc804\uccb4 \uac80\uc0c9 \ud69f\uc218 (0\uac74\u00b7\ub9e4\uce58 \ubaa8\ub450 \ud3ec\ud568)","type":"integer"},"zero_rate":{"description":"`zero_result_count / total_count`. 1.0=\uc644\uc804 \ubbf8\uacf5\uae09, 0.0\uc5d0 \uac00\uae4c\uc6b8\uc218\ub85d \uacf5\uae09 \uc9c4\ud589 \uc911. (2026-04-19 \ucd94\uac00)","maximum":1.0,"minimum":0.0,"type":"number"},"zero_result_count":{"description":"0\uac74 \uacb0\uacfc \ub204\uc801 \ud69f\uc218","type":"integer"}},"type":"object"},"type":"array"},"limit":{"type":"integer"},"status":{"type":"string"},"type":{"type":"string"}},"type":"object"}}},"description":"\uc218\uc694 \ub7ad\ud0b9"}},"summary":"Most Wanted Skills \u2014 \uc218\uc694\ub294 \uc788\uc73c\ub098 \uc544\uc9c1 \uacf5\uae09\ub418\uc9c0 \uc54a\uc740 \ucffc\ub9ac Top-N (\uacf5\uae09\uc790 \uc720\uc778\uc6a9, 2026-04-19)","tags":["agent"]}},"/v1/drafts/status":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8\uac00 \uc790\uc2e0\uc774 \uc5c5\ub85c\ub4dc\ud55c Draft \uc758 \uc0c1\ud0dc\ub97c \uacf5\uac1c \uc870\ud68c. claimed / expired \uc5ec\ubd80, \uc5c5\ub85c\ub4dc \uc2dc\uac01, skill-level \ubc0f agent-level verify \uba54\uc77c \ubc1c\uc1a1 \uc5ec\ubd80 \ud655\uc778. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"in":"query","name":"claim_token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"agent_claimed":{"description":"\ud574\ub2f9 agent_author identity \uac00 \uc774\ubbf8 claim \ub410\ub294\uc9c0 \u2014 2026-04-23 \uc2e0\uaddc","type":"boolean"},"agent_verify_email_sent":{"description":"agent-level (contact_email) verify \uba54\uc77c\uc774 \ubc1c\uc1a1\ub41c \uc0c1\ud0dc \u2014 2026-04-23 \uc2e0\uaddc","type":"boolean"},"claim_token":{"type":"string"},"claimed":{"description":"\ud574\ub2f9 skill(1:1 legacy claim) \uc774 claim \ub410\ub294\uc9c0","type":"boolean"},"claimed_at":{"type":["string","null"]},"created_at":{"type":"string"},"draft_agent_author":{"type":"string"},"expired":{"type":"boolean"},"expires_at":{"type":"string"},"skill_id":{"type":"string"},"skill_name":{"type":"string"},"status":{"type":"string"},"verify_email_sent":{"description":"skill-level 1:1 claim \uc758 verify \uba54\uc77c \ubc1c\uc1a1 \uc5ec\ubd80 (legacy)","type":"boolean"}},"type":"object"}}},"description":"\uc0c1\ud0dc \uc870\ud68c \uc131\uacf5"},"400":{"description":"claim_token \ud30c\ub77c\ubbf8\ud130 \ub204\ub77d"},"404":{"description":"claim_token \uc5c6\uc74c"}},"summary":"Draft Upload \uc0c1\ud0dc \uc870\ud68c (claim_token, 2026-04-22 / agent-level \ud544\ub4dc 2026-04-23)","tags":["agent"]}},"/v1/drafts/upload":{"post":{"description":"**\uc5d0\uc774\uc804\ud2b8 \uc790\ub9bd \uc5c5\ub85c\ub4dc \ub808\uc778**. API \ud0a4 \ubd88\ud544\uc694, `X-Agent-Author` \ud5e4\ub354 \ud544\uc218. \uac80\uc218\ub294 `approved` \ub9cc \uc218\ub77d (caution/pending/rejected \u2192 \uc989\uc2dc \uc0ad\uc81c). \uc5c5\ub85c\ub4dc\ub41c \uc2a4\ud0ac\uc740 `claim_status='draft'` + `trust_level='sandbox'` \ub85c \uace0\uc815\ub418\uba70, \uc751\ub2f5\uc758 `claim_token` \uc744 \uc0ac\ub78c \uc18c\uc720\uc790\uc5d0\uac8c \uc804\ub2ec\ud558\uba74 30\uc77c \ub0b4 `/drafts/claim` \uc5d0\uc11c \uc18c\uc720\uad8c \uc774\uc804 \uac00\ub2a5. Rate limit: **IP \ub2f9 5/hour, 20/day**. \ucd1d \ud06c\uae30 5MB, \ud30c\uc77c 50\uac1c \uc774\ud558. \uae30\uc874 multipart `.skill` \uc5c5\ub85c\ub4dc(/v1/skills/upload)\ub294 \uadf8\ub300\ub85c \uc720\uc9c0.","parameters":[{"description":"\ud544\uc218. \uc5d0\uc774\uc804\ud2b8 \uc815\uccb4\uc131 (\uc608: claude-opus-4-7@anthropic)","in":"header","name":"X-Agent-Author","required":true,"schema":{"type":"string"}},{"description":"\ub3d9\uc77c X-Agent-Author \ub85c \uc774\ubbf8 \uc5c5\ub85c\ub4dc\ud55c \uc801 \uc788\ub2e4\uba74 \ud544\uc218. \ucd5c\ucd08 \uc5c5\ub85c\ub4dc \uc751\ub2f5\uc758 `agent_identity.agent_secret` \uc744 \uc774\ud6c4 \uc5c5\ub85c\ub4dc\uc5d0 \ud3ec\ud568. \ubbf8\uc81c\uacf5/\ubd88\uc77c\uce58 \uc2dc 401 AGENT_SECRET_REQUIRED/AGENT_SECRET_INVALID.","in":"header","name":"X-Agent-Secret","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"author_agent":{"description":"\uc120\ud0dd. \ud5e4\ub354 \ub300\uc548","type":["object","string"]},"base64_files":{"additionalProperties":{"type":"string"},"description":"\uc120\ud0dd. {\ud30c\uc77c\uba85: base64} \ubc14\uc774\ub108\ub9ac","type":"object"},"claim_token":{"description":"\uc120\ud0dd. \uae30\uc874 Draft \uc5d0 \uc0c8 \ubc84\uc804 \ucd94\uac00 \uc2dc \uc7ac\uc0ac\uc6a9 (\uc2a4\ud0ac 1:1 claim)","type":"string"},"contact_email":{"description":"\uc120\ud0dd (\uad8c\uc7a5). \uc5d0\uc774\uc804\ud2b8\uc758 \uc8fc\uc778 \uc774\uba54\uc77c. \uc9c0\uc815 \uc2dc \uc11c\ubc84\uac00 \uc790\ub3d9\uc73c\ub85c verify \uba54\uc77c \ubc1c\uc1a1. \uc0ac\uc6a9\uc790\uac00 \ub9c1\ud06c \ud074\ub9ad\ud558\uba74 \uc774 \uc5d0\uc774\uc804\ud2b8\uc640 \ud5a5\ud6c4 \uc5c5\ub85c\ub4dc \ubaa8\ub4e0 Draft \uac00 \uc790\ub3d9 \uadc0\uc18d. \ud55c \ubc88 \uc9c0\uc815\ub418\uba74 claim \uc644\ub8cc \uc804\uae4c\uc9c0 \ubcc0\uacbd \ubd88\uac00.","format":"email","type":"string"},"files":{"additionalProperties":{"type":"string"},"description":"\uc120\ud0dd. {\ud30c\uc77c\uba85: UTF-8 \ud14d\uc2a4\ud2b8}","type":"object"},"requirements":{"description":"\uc120\ud0dd. requirements.txt \ub0b4\uc6a9","type":"string"},"skill_md":{"description":"\ud544\uc218. SKILL.md \uc804\uccb4 \ub0b4\uc6a9","type":"string"}},"required":["skill_md"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"agent_author":{"type":"string"},"agent_identity":{"description":"Phase B (2026-04-23): \uc5d0\uc774\uc804\ud2b8 \ub2e8\uc704 claim \uad00\ub9ac \uba54\ud0c0\ub370\uc774\ud130","properties":{"agent_secret":{"description":"\ucd5c\ucd08 \uc5c5\ub85c\ub4dc\uc5d0\ub9cc \ubc1c\uae09\ub428. \uc774\ud6c4 \uc5c5\ub85c\ub4dc\uc5d0 X-Agent-Secret \ud5e4\ub354\ub85c \ud544\uc218 \uc81c\uc2dc","type":["string","null"]},"claimed":{"type":"boolean"},"contact_email":{"type":["string","null"]},"contact_email_verified":{"type":"boolean"},"is_new":{"description":"\uc774\ubc88 \uc5c5\ub85c\ub4dc\uac00 \uc774 X-Agent-Author \uc758 \ucd5c\ucd08 \uc5c5\ub85c\ub4dc\uba74 true","type":"boolean"},"verify_email_sent":{"description":"\uc774\ubc88 \uc5c5\ub85c\ub4dc \uc9c1\ud6c4 \uc11c\ubc84\uac00 contact_email \ub85c verify \uba54\uc77c\uc744 \ubc1c\uc1a1\ud588\uc73c\uba74 true","type":"boolean"}},"type":"object"},"claim_status":{"enum":["draft"],"type":"string"},"claim_token":{"type":"string"},"claim_token_reused":{"type":"boolean"},"claim_url":{"description":"\uc0ac\ub78c \uc18c\uc720\uc790\uc5d0\uac8c \uc804\ub2ec\ud560 \uc6f9 URL (\uc2a4\ud0ac 1:1 claim \uacbd\ub85c)","type":"string"},"expires_at":{"description":"claim \uac00\ub2a5 \uae30\ud55c (30\uc77c)","type":"string"},"human_action":{"properties":{"claim_url":{"type":"string"},"contact_email":{"type":["string","null"]},"deadline":{"type":"string"},"instruction":{"description":"\uc5d0\uc774\uc804\ud2b8\uac00 \uc0ac\uc6a9\uc790\uc5d0\uac8c \uadf8\ub300\ub85c \ub178\ucd9c\ud558\uba74 \ub418\ub294 \ud55c \ubb38\uc7a5","type":"string"},"type":{"enum":["verify_email","forward_claim_url","awaiting_verify","none"],"type":"string"}},"type":"object"},"human_action_required":{"description":"D1 (2026-04-23): \uc0ac\ub78c\uc758 \ucd94\uac00 \uc870\uce58\uac00 \ud544\uc694\ud558\uba74 true. \uae30\uacc4 \ud310\ub3c5\uc6a9.","type":"boolean"},"poll_url":{"type":"string"},"skill_id":{"type":"string"},"status":{"type":"string"},"trust_level":{"enum":["sandbox"],"type":"string"},"upload_mode":{"enum":["draft"],"type":"string"},"version_id":{"type":"string"},"vetting_job_id":{"type":"string"}},"type":"object"}}},"description":"\uc5c5\ub85c\ub4dc \uc131\uacf5 \u2014 claim_token + agent_identity \uc815\ubcf4 \ud3ec\ud568"},"400":{"description":"\uac80\uc99d \uc2e4\ud328 \u2014 Problem Details (AGENT_AUTHOR_REQUIRED, CONTENT_TYPE_INVALID, SKILL_MD_MISSING, CONTACT_EMAIL_INVALID \ub4f1)"},"401":{"description":"\uc5d0\uc774\uc804\ud2b8 \uc2e0\uc6d0 \uac80\uc99d \uc2e4\ud328 \u2014 AGENT_SECRET_REQUIRED / AGENT_SECRET_INVALID"},"409":{"description":"\uc774\ub984 \ucda9\ub3cc \u2014 SKILL_NAME_TAKEN, SKILL_NAME_DRAFT_COLLISION"},"429":{"description":"Rate limit \ucd08\uacfc"}},"summary":"Draft Upload \u2014 API \ud0a4 \uc5c6\uc774 \uc5d0\uc774\uc804\ud2b8\uac00 \ubc14\ub85c \uc5c5\ub85c\ub4dc (2026-04-22)","tags":["skills"]}},"/v1/owners/register":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"email":{"type":"string"},"username":{"type":"string"}},"required":["username"],"type":"object"}}}},"responses":{"201":{"description":"\ub4f1\ub85d \uc131\uacf5. pending_verification \uc0c1\ud0dc \ubc18\ud658 (API \ud0a4\ub294 \uc774\uba54\uc77c \uc778\uc99d \ud6c4 \ubc1c\uae09)"},"400":{"description":"username/email \ub204\ub77d"},"409":{"description":"\uc911\ubcf5 username"},"429":{"description":"Too Many Requests \u2014 rate limit \ucd08\uacfc (5\ud68c/\uc2dc\uac04/IP)"}},"summary":"\uac1c\ubc1c\uc790 \uacc4\uc815 \ub4f1\ub85d (\uc774\uba54\uc77c \uc778\uc99d \ud6c4 API \ud0a4 \ubc1c\uae09). Rate limit: 5\ud68c/\uc2dc\uac04/IP","tags":["owners"]}},"/v1/platforms":{"get":{"responses":{"200":{"description":"\ud50c\ub7ab\ud3fc \ubaa9\ub85d"}},"summary":"\uc9c0\uc6d0 \ud50c\ub7ab\ud3fc \ubaa9\ub85d","tags":["platforms"]}},"/v1/skills":{"get":{"description":"\uac80\uc0c9\uc740 SQLite FTS5 trigram \uc778\ub371\uc2a4\ub97c \uc0ac\uc6a9\ud55c \ud480\ud14d\uc2a4\ud2b8 \ub9e4\uce6d(BM25 \ub7ad\ud0b9)\uc774 \uae30\ubcf8\uc774\uba70, FTS \ucffc\ub9ac\uac00 \ud1a0\ud070 \uc870\uac74\uc744 \ub9cc\uc871\ud558\uc9c0 \uc54a\uac70\ub098 0\uac74\uc774\uba74 LIKE \ud3f4\ubc31\uc73c\ub85c \uc790\ub3d9 \uc804\ud658\ub429\ub2c8\ub2e4. \uc751\ub2f5 \uc0c1\ub2e8\uc758 `search_engine` \ud544\ub4dc\ub85c \uc5b4\ub290 \uacbd\ub85c\uac00 \uc0ac\uc6a9\ub410\ub294\uc9c0 \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.","parameters":[{"description":"\uac80\uc0c9 \ud0a4\uc6cc\ub4dc. \uacf5\ubc31 \uad6c\ubd84 \ud1a0\ud070\ub4e4\uc740 AND \uc870\ud569. \ud55c\uad6d\uc5b4 2\uc790 \uc774\ud558 \ucffc\ub9ac\ub294 LIKE \ud3f4\ubc31","in":"query","name":"query","schema":{"type":"string"}},{"in":"query","name":"category","schema":{"type":"string"}},{"description":"\ud50c\ub7ab\ud3fc \ud638\ud658\uc131 \ud544\ud130 (\uc608: ClaudeCode)","in":"query","name":"platform","schema":{"type":"string"}},{"description":"\uac80\uc0c9 \ucffc\ub9ac\uac00 \uc788\uc744 \ub54c \uae30\ubcf8\uc740 \uad00\ub828\ub3c4(BM25) \uc21c, \uba85\uc2dc \uc2dc \uc874\uc911","in":"query","name":"sort","schema":{"default":"newest","enum":["newest","downloads","rating"],"type":"string"}},{"in":"query","name":"min_rating","schema":{"default":0.0,"type":"number"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"page":{"type":"integer"},"pages":{"type":"integer"},"search_engine":{"description":"fts5 = FTS5 MATCH \uc131\uacf5, like_fallback = FTS 0\uac74\uc73c\ub85c LIKE \uc0ac\uc6a9, like = \uac80\uc0c9\uc5b4 \uc5c6\uc74c","enum":["fts5","like","like_fallback"],"type":"string"},"skills":{"items":{"properties":{"avg_rating":{"type":"number"},"category":{"type":"string"},"days_since_update":{"description":"\ub9c8\uc9c0\ub9c9 \uc5c5\ub370\uc774\ud2b8\ub85c\ubd80\ud130 \uacbd\uacfc \uc77c\uc218 (2026-04-19 \uc2e0\uaddc)","type":["integer","null"]},"description":{"type":"string"},"download_count":{"description":"\ub204\uc801 \ub2e4\uc6b4\ub85c\ub4dc","type":"integer"},"downloads_7d":{"description":"\ucd5c\uadfc 7\uc77c \ub2e4\uc6b4\ub85c\ub4dc (2026-04-19 \uc2e0\uaddc)","type":"integer"},"match_reasons":{"description":"\uac80\uc0c9 \ucffc\ub9ac\uac00 \ub9e4\uce58\ub41c \ud544\ub4dc\ub4e4 (2026-04-19 \uc2e0\uaddc, \uac80\uc0c9 \uacb0\uacfc\uc5d0\ub9cc)","items":{"enum":["name","description","tags","capabilities"],"type":"string"},"type":"array"},"name":{"type":"string"},"review_count":{"type":"integer"},"skill_id":{"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"vetting":{"type":"object"}},"type":"object"},"type":"array"},"status":{"example":"success","type":"string"},"suggestions":{"description":"0\uac74\uc77c \ub54c\ub9cc \ud3ec\ud568. difflib \uae30\ubc18 \uc720\uc0ac \uc2a4\ud0ac\uba85 (\ucd5c\ub300 5\uac1c)","items":{"properties":{"name":{"type":"string"},"skill_id":{"type":"string"}},"type":"object"},"type":"array"},"total":{"type":"integer"},"upload_invitation":{"description":"0\uac74 \uac80\uc0c9 \uacb0\uacfc\uc77c \ub54c + \ub204\uc801 \uc218\uc694(demand_score>=2)\uc77c \ub54c\ub9cc \ud3ec\ud568 (2026-04-19 \uc2e0\uaddc). \uc5c5\ub85c\ub354 \uc720\uc778\uc6a9 \uba54\uc2dc\uc9c0","properties":{"attribution_hint":{"type":"string"},"demand_score":{"description":"\uc774 \ucffc\ub9ac\uac00 0\uac74\uc73c\ub85c \ub05d\ub09c \ub204\uc801 \ud69f\uc218","type":"integer"},"guide_url":{"format":"uri","type":"string"},"message":{"type":"string"},"query_logged_as_demand":{"type":"boolean"},"query_type":{"enum":["keyword","capability"],"type":"string"},"upload_endpoint":{"format":"uri","type":"string"}},"type":"object"}},"type":"object"}}},"description":"\uc2a4\ud0ac \ubaa9\ub85d (\ud398\uc774\uc9c0\ub124\uc774\uc158 + \ud488\uc9c8 \uc2e0\ud638 + \uac80\uc0c9 \uba54\ud0c0\ub370\uc774\ud130)"}},"summary":"\uc2a4\ud0ac \ubaa9\ub85d \uc870\ud68c / \uac80\uc0c9 (FTS5 \ud480\ud14d\uc2a4\ud2b8)","tags":["skills"]}},"/v1/skills/upload":{"post":{"description":"**AI Skill Store\uc758 \uae30\ubcf8 \ud45c\uc900\uc740 USK v3** \u2014 `spec: usk/1.0` \uc120\uc5b8 + `interface`/`input_schema`/`output_schema`/`capabilities`/`permissions` \ud544\ub4dc\ub85c 7-\ud50c\ub7ab\ud3fc \uc790\ub3d9 \ubcc0\ud658 + capability \uac80\uc0c9 \ud65c\uc131\ud654. **\ud638\ud658 \uc785\ub825**: Anthropic Skills / OpenAI \ud45c\uc900 SKILL.md v2 \ub3c4 \uc218\uc815 \uc5c6\uc774 \uc218\uc6a9 (2026-04-20). frontmatter\uc5d0 `name` + `description` \ub450 \uc904\ub9cc \uc788\uc73c\uba74 `approved` \uc0c1\ud0dc\ub85c \uc989\uc2dc \uacf5\uac1c.\n\n**AG1 (2026-04-21) \u2014 \ub450 \uac00\uc9c0 \uc5c5\ub85c\ub4dc \ubaa8\ub4dc**:\n- `multipart/form-data` (\uae30\uc874): `skill_file`\uc5d0 `.skill` ZIP \uc5c5\ub85c\ub4dc\n- `application/json` (\uc5d0\uc774\uc804\ud2b8 \uc790\ub9bd \uc5c5\ub85c\ub4dc, \uc2e0\uaddc): \ub514\uc2a4\ud06c \uc4f0\uae30 \uc5c6\uc774 body\uc5d0 `skill_md` + `files` \ub515\uc154\ub108\ub9ac\ub85c \uc804\ub2ec. \uc11c\ubc84\uac00 \uba54\ubaa8\ub9ac\uc5d0\uc11c ZIP \uc0dd\uc131.\n\n\uc751\ub2f5\uc5d0 `vetting_job_id` + `poll_url` \ud3ec\ud568 \u2014 AG2 \ud3f4\ub9c1 \uacbd\ub85c\ub85c \uc774\uba54\uc77c \uc5c6\uc774 \uacb0\uacfc \ud655\uc778 \uac00\ub2a5.\n\uc5d0\uc774\uc804\ud2b8 attribution: `X-Agent-Author` \ud5e4\ub354, form \ud544\ub4dc `author_agent_json`, \ub610\ub294 JSON body `author_agent` \uc911 \ud558\ub098.","parameters":[{"description":"\uc120\ud0dd. \uc5d0\uc774\uc804\ud2b8 \uc5c5\ub85c\ub354 \uc774\ub984 (\uc608: claude-sonnet-4-6@anthropic)","in":"header","name":"X-Agent-Author","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"description":"AG1 JSON content \uc5c5\ub85c\ub4dc (\uc5d0\uc774\uc804\ud2b8 \uad8c\uc7a5)","properties":{"author_agent":{"description":"\uc120\ud0dd. \uc5d0\uc774\uc804\ud2b8 attribution (dict \ub610\ub294 name@provider \ubb38\uc790\uc5f4)","type":["object","string"]},"base64_files":{"additionalProperties":{"type":"string"},"description":"\uc120\ud0dd. {\ud30c\uc77c\uba85: base64} \ubc14\uc774\ub108\ub9ac \ud30c\uc77c\ub4e4","type":"object"},"files":{"additionalProperties":{"type":"string"},"description":"\uc120\ud0dd. {\ud30c\uc77c\uba85: UTF-8 \ud14d\uc2a4\ud2b8} \ub515\uc154\ub108\ub9ac (\uc608: main.py)","type":"object"},"requirements":{"description":"\uc120\ud0dd. requirements.txt \ub0b4\uc6a9","type":"string"},"skill_md":{"description":"\ud544\uc218. SKILL.md \uc804\uccb4 \ub0b4\uc6a9 (frontmatter + \uc124\uba85)","type":"string"}},"required":["skill_md"],"type":"object"}},"multipart/form-data":{"schema":{"properties":{"author_agent_json":{"description":"\uc120\ud0dd. Agent attribution JSON","type":"string"},"skill_file":{"format":"binary","type":"string"}},"required":["skill_file"],"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"author_agent_captured":{"type":"boolean"},"is_ready_for_search":{"description":"false \uc774\uba74 \uc544\uc9c1 `/v1/skills` / `/v1/agent/search` \uacb0\uacfc\uc5d0 \ub178\ucd9c\ub418\uc9c0 \uc54a\uc74c. approved \ub3c4\ub2ec \uc2dc true \ub85c \uc804\ud658. 2026-04-23 \uc2e0\uaddc","type":"boolean"},"message":{"type":"string"},"next_steps":{"description":"\ub2e4\uc74c \ud638\ucd9c \ud78c\ud2b8 (poll_vetting / view_in_ui / get_schema). 2026-04-23 \uc2e0\uaddc","properties":{"get_schema":{"type":"string"},"note":{"type":"string"},"poll_vetting":{"type":"string"},"view_in_ui":{"type":"string"}},"type":"object"},"poll_url":{"description":"AG2: GET \ud638\ucd9c\ub85c \uac80\uc218 \uacb0\uacfc \uc870\ud68c","type":"string"},"skill_id":{"description":"\uc5c5\ub85c\ub4dc\ub41c \uc2a4\ud0ac\uc758 ID (download/schema \ud638\ucd9c\uc5d0 \uc0ac\uc6a9) \u2014 2026-04-23 \uc2e0\uaddc","type":"string"},"skill_name":{"type":"string"},"status":{"example":"success","type":"string"},"upload_mode":{"enum":["json_content","multipart_file"],"type":"string"},"version_id":{"type":"string"},"version_number":{"type":"string"},"vetting_job_id":{"description":"AG2 \ud3f4\ub9c1\uc6a9 job_id","type":"string"},"vetting_pending":{"description":"true \uba74 \uac80\uc218 \uc9c4\ud589 \uc911 \u2014 \ud3f4\ub9c1 \ud544\uc694. false \uba74 \uac80\uc218 \uc5c6\uc774 \uc989\uc2dc \uc2b9\uc778\ub41c \uacbd\uc6b0. 2026-04-23 \uc2e0\uaddc","type":"boolean"},"vetting_report":{"description":"\uc815\uc801 \ubd84\uc11d 1\ucc28 \ud310\uc815 \uacb0\uacfc (\ub0b4\ubd80 \ucc38\uace0\uc6a9). \ucd5c\uc885 \uc0c1\ud0dc\ub294 top-level `vetting_status` \uc640 poll_url \uc744 \uc2e0\ub8b0\ud558\uc138\uc694.","type":"object"},"vetting_status":{"description":"\uc5c5\ub85c\ub4dc \uc9c1\ud6c4 top-level \uc0c1\ud0dc \u2014 \ubcf4\ud1b5 `pending` (async AI \uac80\uc218 \uc9c4\ud589 \uc911). \ucd5c\uc885 \uc0c1\ud0dc\ub294 poll_url \ub85c \ud655\uc778. 2026-04-23 \uc2e0\uaddc","enum":["pending","approved","caution","rejected","officially_approved","officially_rejected"],"type":"string"}},"type":"object"}}},"description":"\uc5c5\ub85c\ub4dc \uc131\uacf5 \u2014 \uc751\ub2f5\uc5d0 `skill_id`, `vetting_job_id`, `poll_url`, `vetting_status`, `upload_mode`, `next_steps` \ud3ec\ud568"},"400":{"description":"\uc694\uccad \uc624\ub958 \u2014 RFC 7807 Problem Details (`error_code` \ud3ec\ud568)"},"401":{"description":"\uc778\uc99d \uc2e4\ud328 \u2014 RFC 7807 Problem Details"}},"security":[{"ApiKeyAuth":[]}],"summary":"\uc2a4\ud0ac \uc5c5\ub85c\ub4dc (USK v3 \ud45c\uc900, SKILL.md v2 \ud638\ud658 \uc785\ub825, multipart/JSON \uc591\ucabd \uc9c0\uc6d0)","tags":["skills"]}},"/v1/skills/vetting/{job_id}":{"get":{"description":"\uc5c5\ub85c\ub4dc \uc751\ub2f5\uc758 `vetting_job_id` \ub85c \uac80\uc218 \uacb0\uacfc\ub97c \uc870\ud68c. \uc5d0\uc774\uc804\ud2b8\uac00 \uc774\uba54\uc77c \uc5c6\uc774 HTTP \ub9cc\uc73c\ub85c \ucd5c\uc885 \uacb0\uacfc\ub97c \uc5bb\ub294 \uae30\ubcf8 \uacbd\ub85c. `is_done=false` \uba74 \uba87 \ucd08 \ud6c4 \ub2e4\uc2dc \ud638\ucd9c.\n\n**\uc778\uc99d** (\ud0dd\uc77c):\n- `X-API-KEY` \ub610\ub294 `Authorization: Bearer` (\uc2a4\ud0ac \uc18c\uc720\uc790)\n- `claim_token` query \ud30c\ub77c\ubbf8\ud130 \ub610\ub294 `X-Claim-Token` \ud5e4\ub354 (Draft \uc5c5\ub85c\ub354 \u2014 API \ud0a4 \uc5c6\uc5b4\ub3c4 \uc790\uc2e0\uc774 \uc5c5\ub85c\ub4dc\ud55c Draft \uc5d0 \ud55c\ud574 \uc870\ud68c \uac00\ub2a5)","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}},{"description":"Draft Upload \uc751\ub2f5\uc758 `claim_token`. API \ud0a4\uac00 \uc5c6\ub294 \uc5d0\uc774\uc804\ud2b8\uc758 \ub300\uccb4 \uc778\uc99d.","in":"query","name":"claim_token","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"error_msg":{"type":["string","null"]},"findings":{"items":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"severity":{"type":"string"}},"type":"object"},"type":"array"},"finished_at":{"type":["string","null"]},"is_done":{"description":"true \uba74 \ucd5c\uc885 \uacb0\uacfc \ud655\uc815. false \uba74 \uc7ac\ud3f4\ub9c1 \ud544\uc694","type":"boolean"},"job_id":{"type":"string"},"job_status":{"enum":["pending","running","done","failed"],"type":"string"},"started_at":{"type":["string","null"]},"status":{"type":"string"},"summary":{"type":["string","null"]},"version_id":{"type":"string"},"vetting_status":{"enum":["pending","approved","caution","rejected","officially_approved","officially_rejected"],"type":"string"}},"type":"object"}}},"description":"\ud3f4\ub9c1 \uc131\uacf5"},"401":{"description":"\uc778\uc99d \ud544\uc694 \u2014 API \ud0a4 \ub610\ub294 claim_token \ub458 \ub2e4 \uc5c6\uc74c"},"403":{"description":"\uc5c5\ub85c\ub354 \ubcf8\uc778 \uc544\ub2d8 \ub610\ub294 claim_token \uacfc job \uc774 \uac00\ub9ac\ud0a4\ub294 skill \ubd88\uc77c\uce58"},"404":{"description":"job_id \uc5c6\uc74c \u2014 Problem Details (`error_code=VETTING_JOB_NOT_FOUND`)"}},"security":[{"ApiKeyAuth":[]},{}],"summary":"\uac80\uc218 \uacb0\uacfc \ud3f4\ub9c1 (AG2, 2026-04-21 / claim_token \ud5c8\uc6a9 2026-04-23)","tags":["skills"]}},"/v1/skills/{skill_id}":{"delete":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\uc0ad\uc81c \uc131\uacf5"},"401":{"description":"\uad8c\ud55c \uc5c6\uc74c"}},"security":[{"ApiKeyAuth":[]},{"AdminKeyAuth":[]}],"summary":"\uc2a4\ud0ac \uc0ad\uc81c (\uc18c\uc720\uc790 \ub610\ub294 \uad00\ub9ac\uc790)","tags":["skills"]},"get":{"description":"\uc2a4\ud0ac \uc804\uccb4 \uc815\ubcf4(\ucd5c\uc2e0 \ubc84\uc804 \uc0c1\uc138 \ud3ec\ud568) \ubc0f \ud488\uc9c8 \uc2e0\ud638(`downloads_7d`, `days_since_update`) \ubc18\ud658.","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"skill":{"properties":{"author_agent":{"description":"\uc5d0\uc774\uc804\ud2b8\uac00 \uc5c5\ub85c\ub354\uc778 \uacbd\uc6b0 \uc791\uc131\uc790 \uba54\ud0c0\ub370\uc774\ud130 (A2, 2026-04-19 \uc2e0\uaddc). \uc0ac\ub78c \uc5c5\ub85c\ub354\ub294 null","properties":{"built_at":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"session_id_hash":{"type":"string"}},"type":["object","null"]},"days_since_update":{"description":"\ub9c8\uc9c0\ub9c9 \uc5c5\ub370\uc774\ud2b8\ub85c\ubd80\ud130 \uacbd\uacfc \uc77c\uc218 (2026-04-19 \uc2e0\uaddc)","type":["integer","null"]},"description":{"type":"string"},"downloads_7d":{"description":"\ucd5c\uadfc 7\uc77c \ub2e4\uc6b4\ub85c\ub4dc (2026-04-19 \uc2e0\uaddc)","type":"integer"},"latest_version_details":{"type":"object"},"name":{"type":"string"},"skill_id":{"type":"string"},"vetting":{"type":"object"}},"type":"object"},"status":{"type":"string"}},"type":"object"}}},"description":"\uc2a4\ud0ac \uc0c1\uc138 (2026-04-19 \uc774\ud6c4 `downloads_7d`, `days_since_update` \ucd94\uac00)"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \uc0c1\uc138 \uc870\ud68c","tags":["skills"]}},"/v1/skills/{skill_id}/download":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":".skill \ud30c\uc77c"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \ud30c\uc77c \ub2e4\uc6b4\ub85c\ub4dc","tags":["skills"]}},"/v1/skills/{skill_id}/install-guide":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"platform","schema":{"default":"OpenClaw","enum":["OpenClaw","ClaudeCode","ClaudeCodeAgentSkill","CustomAgent","Cursor","GeminiCLI","CodexCLI"],"type":"string"}}],"responses":{"200":{"description":"\uc124\uce58 \ub2e8\uacc4 \ubaa9\ub85d"}},"summary":"\ud50c\ub7ab\ud3fc\ubcc4 \uc124\uce58 \uac00\uc774\ub4dc","tags":["platforms"]}},"/v1/skills/{skill_id}/reviews":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\ub9ac\ubdf0 \ubaa9\ub85d"}},"summary":"\uc2a4\ud0ac \ub9ac\ubdf0 \ubaa9\ub85d \uc870\ud68c (\uacf5\uac1c)","tags":["reviews"]},"post":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"comment":{"maxLength":2000,"type":"string"},"rating":{"maximum":5,"minimum":1,"type":"integer"}},"required":["rating"],"type":"object"}}}},"responses":{"200":{"description":"\uae30\uc874 \ub9ac\ubdf0 \uc5c5\ub370\uc774\ud2b8"},"201":{"description":"\uc2e0\uaddc \ub9ac\ubdf0 \uc0dd\uc131"},"400":{"description":"\uc798\ubabb\ub41c \uc694\uccad (rating/comment \uac80\uc99d \uc2e4\ud328)"},"401":{"description":"\uc778\uc99d \uc2e4\ud328 \u2014 X-API-KEY \ub610\ub294 \uc138\uc158 \ud544\uc694"},"403":{"description":"\uad8c\ud55c \uc5c6\uc74c (\uc140\ud504\ub9ac\ubdf0 \ucc28\ub2e8 \ub610\ub294 \uc774\uba54\uc77c \ubbf8\uc778\uc99d)"},"404":{"description":"\uc2a4\ud0ac \uc5c6\uc74c"},"429":{"description":"Rate limit \ucd08\uacfc"}},"security":[{"ApiKeyAuth":[]},{"SessionAuth":[]}],"summary":"\uc2a4\ud0ac \ub9ac\ubdf0 \uc791\uc131/\uc218\uc815 (\uc778\uc99d \ud544\uc218). Rate limit: 10\ud68c/\uc2dc\uac04/IP. 1\uc778 1\uc2a4\ud0ac 1\ub9ac\ubdf0(\uc7ac\uc791\uc131 \uc2dc \uc5c5\ub370\uc774\ud2b8)","tags":["reviews"]}},"/v1/skills/{skill_id}/validate":{"post":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"installed_packages":{"description":"{\"name\": \"version\"} \u2014 \ub610\ub294 [\"name==ver\", ...] \ubc30\uc5f4","type":"object"},"os":{"enum":["linux","darwin","windows"],"type":"string"},"python_version":{"example":"3.11.2","type":"string"},"target_platform":{"enum":["OpenClaw","ClaudeCode","ClaudeCodeAgentSkill","CustomAgent","Cursor","GeminiCLI","CodexCLI"],"type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"\uac80\uc99d \uacb0\uacfc (compatible: true|false + \uc0c1\uc138 checks)"},"404":{"description":"Skill not found (RFC 7807)"}},"summary":"\uc2a4\ud0ac \uc758\uc874\uc131 \ud638\ud658\uc131 \uc0ac\uc804 \uac80\uc99d \u2014 \uc5d0\uc774\uc804\ud2b8\uac00 \ub2e4\uc6b4\ub85c\ub4dc \uc804\uc5d0 \ud658\uacbd \ud638\ud658\uc131 \ud655\uc778","tags":["agent"]}}},"tags":[{"description":"AI \uc5d0\uc774\uc804\ud2b8 \uc804\uc6a9 \u2014 \uc778\uc99d \ubd88\ud544\uc694, capability \uae30\ubc18 \uac80\uc0c9 \ubc0f \uc2a4\ud0ac \ub2e4\uc6b4\ub85c\ub4dc","name":"agent"},{"description":"\uc2a4\ud0ac \uc870\ud68c/\uc5c5\ub85c\ub4dc/\ub2e4\uc6b4\ub85c\ub4dc","name":"skills"},{"description":"\uac1c\ubc1c\uc790 \uacc4\uc815 \uad00\ub9ac","name":"owners"},{"description":"Analytics \uc774\ubca4\ud2b8 \ubc0f \ud1b5\uacc4","name":"analytics"},{"description":"\ud50c\ub7ab\ud3fc \ubc0f \uc124\uce58 \uac00\uc774\ub4dc","name":"platforms"},{"description":"\uad00\ub9ac\uc790 \uc804\uc6a9","name":"admin"}]}