{"files":{"SKILL.md":"---\nname: groundhog-day-api\ndescription: \"Groundhog Day API skill. Use when working with Groundhog Day for api. Covers 5 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Groundhog Day API\nAPI version: 1.2.1\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1\n\n## Setup\n1. No auth setup needed\n2. GET /api/v1 -- root\n3. Explore available endpoints below\n\n## Endpoints\n5 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Api\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /api/v1 | Root |\n| GET | /api/v1/groundhogs | Get all groundhogs |\n| GET | /api/v1/groundhogs/{slug} | Get a groundhog by slug |\n| GET | /api/v1/predictions | Get predictions for a given year |\n| GET | /api/v1/spec | Get JSON schema |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all api?\" -> GET /api/v1\n- \"List all groundhogs?\" -> GET /api/v1/groundhogs\n- \"Get groundhog details?\" -> GET /api/v1/groundhogs/{slug}\n- \"List all predictions?\" -> GET /api/v1/predictions\n- \"List all spec?\" -> GET /api/v1/spec\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Error responses include status codes and descriptions in the spec\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 Groundhog Day API\n@base https://virtserver.swaggerhub.com/pcraig3/groundhog-day-api/1.2.1\n@version 1.2.1\n@endpoints 5\n@toc api(5)\n\n@endpoint GET /api/v1\n@desc Root\n@returns(200) {message: str, _links: map{self: map{href: str}, groundhogs: map{href: str}, groundhog: map{href: str}, predictions: map{href: str}, spec: map{href: str}}} # OK\n\n@endpoint GET /api/v1/groundhogs\n@desc Get all groundhogs\n@optional {country: str # Filter groundhogs by country of origin (USA or Canada)., isGroundhog: str(1/0/true/false) # Filter groundhogs by type (actual, alive groundhogs, or other prognosticators)}\n@returns(200) {groundhogs: [map]} # OK\n\n@endpoint GET /api/v1/groundhogs/{slug}\n@desc Get a groundhog by slug\n@returns(200) {groundhog: map{id: int, slug: str, shortname: str, name: str, city: str, region: str, country: str, coordinates: str, source: str, contact: str, currentPrediction: str, isGroundhog: int(binary), type: str, active: int(binary), description: str, image: str, predictions: [map], predictionsCount: int}} # OK\n@errors {400: Bad Request}\n\n@endpoint GET /api/v1/predictions\n@desc Get predictions for a given year\n@optional {year: int # A calendar year}\n@returns(200) {predictions: [map]} # OK\n@errors {302: Found, 400: Bad Request}\n\n@endpoint GET /api/v1/spec\n@desc Get JSON schema\n@returns(200) OK\n\n@end\n"}}