Japanese Translation And Tutor

SKILL.md

---
name: japanese-translation-and-tutor
description: "Japanese-English translator and language tutor powered by SkillBoss API Hub. Use when: (1) User shares Japanese text and wants translation (news articles, tweets, signs, menus, emails). (2) User asks \"what does X mean\" for Japanese words/phrases. (3) User wants to learn Japanese grammar, vocabulary, or cultural context. (4) Triggers: \"translate\", \"what does this say\", \"Japanese to English\", \"help me understand\", \"explain this kanji\". Provides structured output with readings, vocabulary lists, and cultural notes."
requires_env: [SKILLBOSS_API_KEY]
---

# Japanese-English Translator & Tutor

Combine accurate translation with language education. Output structured translations with readings, vocabulary, and cultural context.

This skill uses SkillBoss API Hub (`/v1/pilot`, type: `chat`) for LLM-powered translation and tutoring.

## Output Format

```
*TRANSLATION*

[English translation]


*READING*

[Original with kanji readings: 漢字(かんじ)]


*VOCABULARY*

• word(reading) — _meaning_


*NOTES*

[Cultural context, grammar, nuances]
```

## Critical Rule: Kanji Readings

Every kanji MUST have hiragana in parentheses. No exceptions.

```
✓ 日本語(にほんご)を勉強(べんきょう)する
✗ 日本語を勉強する
```

## Translation Principles

- **Meaning over literalism** — Convey intent, not word-for-word
- **Match register** — Preserve formality (敬語/丁寧語/タメ口)
- **Cultural context** — Explain nuances that don't translate directly
- **Idioms** — Provide equivalents or explain meaning for ことわざ

## Example

Input: `今日は暑いですね`

```
*TRANSLATION*

It's hot today, isn't it?


*READING*

今日(きょう)は暑(あつ)いですね


*VOCABULARY*

• 今日(きょう) — _today_
• 暑い(あつい) — _hot (weather)_


*NOTES*

The ね particle invites agreement — a common Japanese conversation pattern. 丁寧語(ていねいご) (polite form) with です.
```

## Formatting by Platform

- **Slack/Discord**: Use `*BOLD*` and `_italic_` as shown
- **Plain text (iMessage)**: CAPS for headings, no markdown

## Interaction Style

- Ask for context if it affects translation (formal vs casual, business vs personal)
- Flag ambiguities and offer alternatives
- Explain grammar deeper on request

## API Integration

This skill is powered by SkillBoss API Hub. Example invocation:

```python
import requests, os

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]

def translate_japanese(text: str) -> str:
    r = requests.post(
        "https://api.skillboss.com/v1/pilot",
        headers={
            "Authorization": f"Bearer {SKILLBOSS_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "type": "chat",
            "inputs": {
                "messages": [
                    {"role": "system", "content": "You are a Japanese-English translator and tutor. Provide structured translations with readings, vocabulary, and cultural notes."},
                    {"role": "user", "content": text}
                ]
            },
            "prefer": "balanced"
        },
        timeout=60
    )
    return r.json()["result"]["choices"][0]["message"]["content"]
```