{"files":{"SKILL.md":"---\nname: psycholinguistic-text-analytics\ndescription: \"Psycholinguistic Text Analytics API skill. Use when working with Psycholinguistic Text Analytics for communication, emotion, ekman-emotion. Covers 8 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Psycholinguistic Text Analytics\nAPI version: 1.0\n\n## Auth\nApiKey x-api-key in header\n\n## Base URL\nhttps://api.symanto.net\n\n## Setup\n1. Set your API key in the appropriate header\n2. Verify API access with a test request\n3. POST /communication -- create first communication\n\n## Endpoints\n8 endpoints across 8 groups. See references/api-spec.lap for full details.\n\n### Communication\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /communication | Communication & Tonality |\n\n### Emotion\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /emotion | Emotion Analysis |\n\n### Ekman-emotion\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /ekman-emotion | Emotion Analysis |\n\n### Personality\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /personality | Personality Traits |\n\n### Sentiment\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /sentiment | Sentiment Analysis |\n\n### Topic-sentiment\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /topic-sentiment | Extracts topics and sentiments and relates them. |\n\n### Brand-recommendation\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /brand-recommendation | Predicts whether a phrase is a promoter, detractor or indifferent |\n\n### Language-detection\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /language-detection | Language Detection |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a communication?\" -> POST /communication\n- \"Create a emotion?\" -> POST /emotion\n- \"Create a ekman-emotion?\" -> POST /ekman-emotion\n- \"Create a personality?\" -> POST /personality\n- \"Create a sentiment?\" -> POST /sentiment\n- \"Create a topic-sentiment?\" -> POST /topic-sentiment\n- \"Create a brand-recommendation?\" -> POST /brand-recommendation\n- \"Create a language-detection?\" -> POST /language-detection\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 Psycholinguistic Text Analytics\n@base https://api.symanto.net\n@version 1.0\n@auth ApiKey x-api-key in header\n@endpoints 8\n@toc communication(1), emotion(1), ekman-emotion(1), personality(1), sentiment(1), topic-sentiment(1), brand-recommendation(1), language-detection(1)\n\n@group communication\n@endpoint POST /communication\n@desc Communication & Tonality\n@optional {all: bool=false}\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@group emotion\n@endpoint POST /emotion\n@desc Emotion Analysis\n@optional {all: bool=false}\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@group ekman-emotion\n@endpoint POST /ekman-emotion\n@desc Emotion Analysis\n@optional {all: bool=false}\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@group personality\n@endpoint POST /personality\n@desc Personality Traits\n@optional {all: bool=false}\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@group sentiment\n@endpoint POST /sentiment\n@desc Sentiment Analysis\n@optional {all: bool=false}\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@group topic-sentiment\n@endpoint POST /topic-sentiment\n@desc Extracts topics and sentiments and relates them.\n@optional {domain: str(Ecom/Employee/Hotel/Restaurant) # Provide analysis domain for better extraction (optional)}\n@returns(200)\n\n@endgroup\n\n@group brand-recommendation\n@endpoint POST /brand-recommendation\n@desc Predicts whether a phrase is a promoter, detractor or indifferent\n@optional {domain: str(Airlines/Automotive/Banking/Ecom/Employee/Gaming/Hotel/Pharma/Retail/Restaurant/ConsumerElectronics) # (optional) Provide analysis domain for better extraction}\n@returns(200)\n\n@endgroup\n\n@group language-detection\n@endpoint POST /language-detection\n@desc Language Detection\n@returns(200) Successful Response\n@errors {422: Validation Error}\n\n@endgroup\n\n@end\n"}}