{"files":{"SKILL.md":"---\nname: searchly-api-v1\ndescription: \"SearchLy API v1 API skill. Use when working with SearchLy API v1 for similarity, song. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# SearchLy API v1\nAPI version: 1.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://searchly.asuarez.dev/api/v1\n\n## Setup\n1. No auth setup needed\n2. GET /similarity/by_song -- api endpoint to search similarity using a song identifier\n3. POST /similarity/by_content -- create first by_content\n\n## Endpoints\n3 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Similarity\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /similarity/by_song | API endpoint to search similarity using a song identifier |\n| POST | /similarity/by_content | API endpoint to search similarity using content |\n\n### Song\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /song/search | API endpoint to search songs from the database given a query |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all by_song?\" -> GET /similarity/by_song\n- \"Create a by_content?\" -> POST /similarity/by_content\n- \"Search search?\" -> GET /song/search\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api SearchLy API v1\n@base https://searchly.asuarez.dev/api/v1\n@version 1.0\n@endpoints 3\n@toc similarity(2), song(1)\n\n@group similarity\n@endpoint GET /similarity/by_song\n@desc API endpoint to search similarity using a song identifier\n@required {song_id: int # Song identifier.}\n@returns(200) {error: bool, message: str, response: map{similarity_list: [map]}} # Standard SearchLy API v1 JSON response. You should check the `error` attribute to determine if there was an error.\n\n@endpoint POST /similarity/by_content\n@desc API endpoint to search similarity using content\n@optional {content: str # Content for searching similarity.}\n@returns(200) {error: bool, message: str, response: map{similarity_list: [map]}} # Standard SearchLy API v1 JSON response. You should check the `error` attribute to determine if there was an error.\n\n@endgroup\n\n@group song\n@endpoint GET /song/search\n@desc API endpoint to search songs from the database given a query\n@required {query: str # Query.}\n@returns(200) {error: bool, message: str, response: map{results: [map]}} # Standard SearchLy API v1 JSON response. You should check the `error` attribute to determine if there was an error.\n\n@endgroup\n\n@end\n"}}