{"files":{"SKILL.md":"---\nname: color-name-api\ndescription: \"Color Name API skill. Use when working with Color Name for root, health, docs. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Color Name API\nAPI version: 1.1.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://api.color.pizza/\n\n## Setup\n1. No auth setup needed\n2. GET / -- get api metadata and discovery information\n3. Explore available endpoints below\n\n## Endpoints\n7 endpoints across 7 groups. See references/api-spec.lap for full details.\n\n### Root\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | / | Get API metadata and discovery information |\n\n### Health\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /health | Health check endpoint |\n\n### Docs\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/docs/ | Get API Documentation |\n\n### V1\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/ | Get color names for specific hex values |\n\n### Names\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/names/ | Search for colors by name |\n\n### Lists\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/lists/ | Get available color name lists |\n\n### Swatch\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/swatch/ | Generate a color swatch for any color |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all resource?\" -> GET /\n- \"List all health?\" -> GET /health\n- \"List all docs?\" -> GET /v1/docs/\n- \"List all v1?\" -> GET /v1/\n- \"List all names?\" -> GET /v1/names/\n- \"List all lists?\" -> GET /v1/lists/\n- \"List all swatch?\" -> GET /v1/swatch/\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 Color Name API\n@base https://api.color.pizza/\n@version 1.1.0\n@endpoints 7\n@toc root(1), health(1), docs(1), v1(1), names(1), lists(1), swatch(1)\n\n@group root\n@endpoint GET /\n@desc Get API metadata and discovery information\n@returns(200) {name: str, version: str, description: str, endpoints: map{colors: str, colorsByPath: str, names: str, lists: str, swatch: str, docs: str, health: str}, documentation: str, source: str} # OK - Returns API metadata\n\n@endgroup\n\n@group health\n@endpoint GET /health\n@desc Health check endpoint\n@returns(200) {status: str, timestamp: str(date-time)} # OK - API is healthy and operational\n\n@endgroup\n\n@group docs\n@endpoint GET /v1/docs/\n@desc Get API Documentation\n@returns(200) OK - Returns the HTML documentation page.\n\n@endgroup\n\n@group v1\n@endpoint GET /v1/\n@desc Get color names for specific hex values\n@returns(200) {colors: [map], paletteTitle: str} # OK\n@errors {400: BAD REQUEST, 404: NOT FOUND, 409: CONFLICT - Requested more unique colors than available}\n\n@endgroup\n\n@group names\n@endpoint GET /v1/names/\n@desc Search for colors by name\n@returns(200) {colors: [map]} # OK\n@errors {404: NOT FOUND}\n\n@endgroup\n\n@group lists\n@endpoint GET /v1/lists/\n@desc Get available color name lists\n@optional {list: str # The name of a specific color name list to retrieve details for}\n@returns(200) OK\n@errors {400: BAD REQUEST, 404: NOT FOUND}\n\n@endgroup\n\n@group swatch\n@endpoint GET /v1/swatch/\n@desc Generate a color swatch for any color\n@required {color: str # The hex value of the color to retrieve without '#'}\n@optional {name: str # The name of the color to display on the swatch}\n@returns(200) OK\n@errors {400: BAD REQUEST}\n\n@endgroup\n\n@end\n"}}