{"files":{"SKILL.md":"---\nname: libretranslate\ndescription: \"LibreTranslate API skill. Use when working with LibreTranslate for detect, frontend, health. Covers 7 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# LibreTranslate\nAPI version: 1.8.4\n\n## Auth\nApiKey api_key in formData\n\n## Base URL\nNot specified.\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /frontend/settings -- retrieve frontend settings\n3. POST /detect -- create first detect\n\n## Endpoints\n7 endpoints across 7 groups. See references/api-spec.lap for full details.\n\n### Detect\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /detect | Detect Language of Text |\n\n### Frontend\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /frontend/settings | Retrieve Frontend Settings |\n\n### Health\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /health | Health Check |\n\n### Languages\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /languages | Get Supported Languages |\n\n### Suggest\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /suggest | Submit a Suggestion to Improve a Translation |\n\n### Translate\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /translate | Translate Text |\n\n### Translate_file\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /translate_file | Translate a File |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a detect?\" -> POST /detect\n- \"List all settings?\" -> GET /frontend/settings\n- \"List all health?\" -> GET /health\n- \"List all languages?\" -> GET /languages\n- \"Create a suggest?\" -> POST /suggest\n- \"Create a translate?\" -> POST /translate\n- \"Create a translate_file?\" -> POST /translate_file\n- \"How to authenticate?\" -> See Auth section above\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- 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 LibreTranslate\n@version 1.8.4\n@auth ApiKey api_key in formData\n@endpoints 7\n@toc detect(1), frontend(1), health(1), languages(1), suggest(1), translate(1), translate_file(1)\n\n@group detect\n@endpoint POST /detect\n@desc Detect Language of Text\n@required {q: str # Text to detect}\n@optional {api_key: str # API key}\n@returns(200) Detections\n@errors {400: Invalid request, 403: Banned, 429: Slow down, 500: Detection error}\n\n@endgroup\n\n@group frontend\n@endpoint GET /frontend/settings\n@desc Retrieve Frontend Settings\n@returns(200) frontend settings\n\n@endgroup\n\n@group health\n@endpoint GET /health\n@desc Health Check\n@returns(200) Service is healthy\n\n@endgroup\n\n@group languages\n@endpoint GET /languages\n@desc Get Supported Languages\n@returns(200) List of supported languages\n\n@endgroup\n\n@group suggest\n@endpoint POST /suggest\n@desc Submit a Suggestion to Improve a Translation\n@required {q: str # Original text, s: str # Suggested translation, source: str # Language of original text, target: str # Language of suggested translation}\n@returns(200) Success\n@errors {403: Not authorized}\n\n@endgroup\n\n@group translate\n@endpoint POST /translate\n@desc Translate Text\n@required {q: any # Text(s) to translate, source: str # Source language code or \"auto\" for auto detection, target: str # Target language code}\n@optional {format: str(text/html)=text # Format of source text:  * `text` - Plain text  * `html` - HTML markup, alternatives: int=0 # Preferred number of alternative translations, api_key: str # API key}\n@returns(200) Translation\n@errors {400: Invalid request, 403: Banned, 429: Slow down, 500: Translation error}\n\n@endgroup\n\n@group translate_file\n@endpoint POST /translate_file\n@desc Translate a File\n@required {file: any # File to translate, source: str # Source language code  or \"auto\" for auto detection, target: str # Target language code}\n@optional {api_key: str # API key}\n@returns(200) Translated file\n@errors {400: Invalid request, 403: Banned, 429: Slow down, 500: Translation error}\n\n@endgroup\n\n@end\n"}}