{
  "schema_version": "1.0",
  "name": "FindSkills",
  "description": "AI Skills directory with 112,000+ skills. Search, filter, and discover tools for AI agents across 13 categories.",
  "url": "https://findskills.org",
  "agent_endpoints": {
    "llms_txt": {
      "url": "/llms.txt",
      "description": "Concise LLM-readable summary with API usage examples. Start here.",
      "content_type": "text/markdown"
    },
    "openapi": {
      "url": "/api/v1/openapi",
      "description": "OpenAPI 3.0.3 specification for the REST API.",
      "content_type": "application/json"
    },
    "stats": {
      "url": "/api/v1/stats",
      "description": "Quick dataset overview: total count, category/source/auth breakdowns. Call this first.",
      "content_type": "application/json"
    },
    "ai_plugin": {
      "url": "/.well-known/ai-plugin.json",
      "description": "ChatGPT/OpenAI plugin manifest.",
      "content_type": "application/json"
    }
  },
  "mcp_server": {
    "name": "findskills-mcp",
    "description": "MCP Server for FindSkills — search and discover AI Agent Skills via Model Context Protocol.",
    "install": "npx findskills-mcp",
    "transport": "stdio",
    "npm": "https://www.npmjs.com/package/findskills-mcp",
    "tools": ["search_skills", "list_skills", "get_skill", "get_stats", "list_tags"]
  },
  "api": {
    "base_url": "https://findskills.org/api/v1",
    "auth": "optional — pass Authorization: Bearer fs-key-xxx for higher limits and full fields. Get a free key at https://findskills.org/developers",
    "rate_limit": "per-IP 30 req/min. Guest: 15 detail lookups/5min, 30 results/day. Developer: 100 detail lookups/5min, 300 results/day. Sign in with GitHub at /developers for an API key.",
    "endpoints": [
      {
        "method": "GET",
        "path": "/stats",
        "description": "Dataset overview: total count, breakdowns by category/source/auth_type."
      },
      {
        "method": "GET",
        "path": "/skills",
        "description": "List and filter skills. Each skill includes quality_score (0-100) and safety_score (0-100) with safety_tier (verified/community/caution). Use sort=safety or min_safety=70 to find verified skills safe for agent execution. Responses include next/prev pagination URLs.",
        "parameters": ["category", "q", "source", "auth_type", "sort", "min_quality", "min_safety", "limit", "offset", "fields"]
      },
      {
        "method": "GET",
        "path": "/skills/{id}",
        "description": "Get full detail for a single skill."
      },
      {
        "method": "GET",
        "path": "/search?q={query}",
        "description": "Weighted relevance search across all skills."
      },
      {
        "method": "GET",
        "path": "/tags",
        "description": "List all tags with counts."
      },
      {
        "method": "GET",
        "path": "/openapi",
        "description": "OpenAPI 3.0.3 JSON specification."
      }
    ]
  },
  "categories": ["search", "coding", "data", "communication", "media", "automation", "security", "ai-ml", "devops", "finance", "productivity", "integration", "other"],
  "recommended_flow": [
    "1. GET /api/v1/stats for dataset overview (total count, categories, sources)",
    "2. GET /api/v1/skills?category=X&limit=10 to browse by category",
    "3. GET /api/v1/search?q=keyword to find specific tools by relevance",
    "4. GET /api/v1/skills/{id} for full details on a specific skill",
    "5. Follow 'next' URL in response to paginate through results"
  ]
}