{
 "openapi": "3.1.0",
 "info": {
  "title": "SkillsPicker API",
  "version": "1.0.0",
  "description": "Recommend open-license agent skills (SKILL.md) for a software project. Free result: match count and 2 picks with install commands. The full ranked list is a $9 one-time unlock on the website.",
  "contact": {
   "email": "nichols-ventures@mail.grokbot.com"
  }
 },
 "servers": [
  {
   "url": "https://skillspicker.com"
  }
 ],
 "paths": {
  "/api/recommend": {
   "get": {
    "operationId": "recommendSkills",
    "summary": "Recommend agent skills for a project",
    "description": "Use when a user starts a project or asks which agent skills, Claude Code skills, Cursor rules or SKILL.md files to install. Pass tags from the project files, a description, or a public GitHub repo URL.",
    "parameters": [
     {
      "name": "tags",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Comma list of stack and task tags, e.g. nextjs,supabase,testing. Tag names: https://skillspicker.com/rules.json"
     },
     {
      "name": "q",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Project description in plain words"
     },
     {
      "name": "repo",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "Public GitHub repo URL"
     }
    ],
    "responses": {
     "200": {
      "description": "Free result",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "found": {
           "type": "integer",
           "description": "Skills in the database that match"
          },
          "curated_picks": {
           "type": "integer"
          },
          "tags": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "free_picks": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "description": {
              "type": "string"
             },
             "repo": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "license": {
              "type": "string"
             },
             "install": {
              "type": "string"
             }
            }
           }
          },
          "full_list_url": {
           "type": "string"
          },
          "full_list_price_usd": {
           "type": "number"
          }
         }
        }
       }
      }
     },
     "400": {
      "description": "No usable input"
     },
     "429": {
      "description": "Rate limit"
     }
    }
   }
  }
 }
}