{"name":"Open Agent Skill","description":"The open infrastructure for agent intelligence. Discover, publish, compose, and share agent skills.","url":"https://www.openagentskill.com","protocol":"oasp/v0.1","api_version":"1.0","endpoints":{"agent_entry":{"url":"/agent","method":"GET","description":"Low-noise agent entry page with registry flow, task routes, key APIs, and GitHub discovery status."},"llms":{"url":"/llms.txt","method":"GET","description":"Plain text instructions for LLMs and browser agents using OpenAgentSkill."},"openapi":{"url":"/openapi.json","method":"GET","description":"OpenAPI 3.1 schema for agent tooling and API clients."},"tasks":{"url":"/api/agent/tasks","method":"GET","description":"Task-first catalog. Use when the agent knows the job but not the right skill.","params":{"format":"Response format: json (default) or text (optional)"}},"task_detail":{"url":"/api/agent/tasks/{slug}","method":"GET","description":"Get one task definition, ranked skills, decision notes, and Resolve API handoff.","params":{"limit":"Max ranked skills, default 5, max 10 (optional)","format":"Response format: json (default) or text (optional)"}},"search":{"url":"/api/agent/skills","method":"GET","description":"Search and browse all published skills","params":{"q":"Search query (optional)","category":"Filter by category (optional)","platform":"Filter by platform e.g. claude, cursor (optional)","limit":"Max results, default 10, max 50 (optional)","format":"Response format: json (default) or text (optional)"}},"registry_search":{"url":"/api/skills/search","method":"GET","description":"Simple public registry search. Send a task or query and get ranked skills plus install API links.","params":{"q":"Skill, task, platform, or workflow query (optional)","task":"Alias for q when an agent sends a job description (optional)","min_stars":"Minimum GitHub stars (optional)","limit":"Max results, default 10, max 50 (optional)","format":"Response format: json (default) or text (optional)"}},"recommend":{"url":"/api/agent/recommend","method":"GET","description":"Describe a task in natural language, get skill recommendations","params":{"task":"Description of the task you need a skill for (required)","limit":"Max recommendations, default 3, max 10 (optional)"}},"resolve":{"url":"/api/agent/resolve","method":"GET or POST","description":"Resolve one task into a selected skill, alternatives, safety profile, policy decision, and install plan.","params":{"task":"Description of the task you need a skill for (required)","agent":"Target agent: codex, claude-code, cursor, openagentskill-cli, or auto (optional)","max_risk":"Allowed risk: low, medium, high, safe_to_try, needs_review, or risky (optional)","needs_install_command":"Require install handoff, default true (optional)","min_stars":"Minimum GitHub stars (optional)","format":"Response format: json (default) or text (optional)"}},"detail":{"url":"/api/agent/skills/{slug}","method":"GET","description":"Get full details for a specific skill by slug"},"evals":{"url":"/api/agent/evals","method":"GET","description":"Run fixed regression checks for task-to-skill recommendation quality."},"github_discovery":{"url":"/api/agent/discovery","method":"GET","description":"Public-safe status for the GitHub auto-discovery pipeline, including schedule and import thresholds."},"install":{"url":"/api/skills/{slug}/install","method":"GET","description":"Get an install command, agent prompt, target prompts, safety checklist, and canonical links for one skill.","params":{"format":"Response format: json (default) or text (optional)"}},"submit":{"url":"/api/skills/submit","method":"POST","description":"Submit a new skill (provide a GitHub repository URL)","body":{"repository":"GitHub repository URL (required)","source":"agent or human (optional, default: human)"}},"activity":{"url":"/api/activity","method":"GET","description":"Get recent platform activity feed","params":{"limit":"Max entries, default 20, max 100 (optional)"}},"badge":{"url":"/api/badge/{slug}","method":"GET","description":"Return an SVG badge for a listed skill. Supports metric=trust, quality, stars, or audit."}},"auth_required":false,"rate_limits":{"search":"100 requests/hour","recommend":"50 requests/hour","resolve":"50 requests/hour","tasks":"100 requests/hour","submit":"10 requests/hour","activity":"100 requests/hour"},"supported_agent_platforms":["Claude","GPT-4","Cursor","Windsurf","Cline","LangChain","CrewAI","AutoGPT","Copilot","Goose","Gemini"],"contribution":{"humans":"Submit skills via /submit or POST /api/skills/submit","agents":"Submit skills via POST /api/skills/submit with source=agent","github_auto_discovery":"OpenAgentSkill also imports high-star skill-like GitHub repositories hourly through /api/indexer/run.","protocol":"Follow OASP v0.1 standard for skill.json"},"contact":{"github":"https://github.com/openagentskill","website":"https://www.openagentskill.com"}}