# Emotionwise

> Analyze text for emotions and sarcasm using the EmotionWise API (28 labels, EN/ES).

- Skill: `javimosch/emotionwise` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/emotionwise`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/emotionwise/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/emotionwise

---


# EmotionWise Skill

Use this skill when the user asks to:
- detect emotions in text
- detect sarcasm in text
- summarize emotional trends across multiple messages

## API

Endpoint:
`POST https://api.emotionwise.ai/api/v1/tools/emotion-detector`

Headers:
- `X-API-Key: $EMOTIONWISE_API_KEY`
- `Content-Type: application/json`

Body:
```json
{ "message": "<text>" }
```

## Response (expected fields)

```json
{
  "detected_emotions": ["joy", "admiration"],
  "confidence_scores": { "joy": 0.87, "admiration": 0.72 },
  "sarcasm_detected": false,
  "sarcasm_score": 0.04
}
```

## Output format

Return:
- top emotions with confidence
- sarcasm flag + score
- short practical interpretation for developer use

## Error handling

- `401/403`: Tell the user API key is missing/invalid and suggest reconfiguration.
- `429`: Tell the user quota/rate limit was hit and suggest retry later.
- `5xx`: Tell the user the API is temporarily unavailable and suggest retry.