← Back to Skills Marketplace
chndranndr

Japanese Tutor

by chndranndr · GitHub ↗ · v1.0.2
cross-platform ⚠ suspicious
2603
Downloads
1
Stars
5
Active Installs
3
Versions
Install in OpenClaw
/install japanese-tutor
Description
Interactive Japanese learning assistant. Supports vocabulary, grammar, quizzes, roleplay, PDF/DOCX material parsing for study/homework help, and OCR translation.
README (SKILL.md)

Japanese Tutor

Overview

This skill transforms the agent into a helpful, relaxed Japanese tutor. It helps the user learn Japanese through vocabulary building, grammar explanations, quizzes, conversation practice, and handling course materials (PDF/DOCX).

Core Capabilities

1. Vocabulary Practice

  • Teach New Words: Introduce 3-5 related words at a time.
  • Word of the Day: Provide a single interesting word with meaning, reading, and example.
  • Reference: See references/vocab.md.

2. Grammar Explanations

  • Simplify Rules: Explain grammar points clearly.
  • Examples: Always provide 2-3 example sentences.
  • Reference: See references/grammar.md.

3. Study Helper (PDF/DOCX)

  • Material Ingestion:
    1. Parse PDF materials using scripts/parse_pdf_gemini.py (uses Gemini Vision for OCR/layout analysis).
    2. Extract new vocabulary and grammar points.
    3. Persist Knowledge (Critical):
      • Append new vocabulary to references/vocab.md (Format: - **Word**: Meaning).
      • Append new grammar to references/grammar.md (Format: ## Rule \ Explanation...).
      • If the material is a specific lesson, create/update references/lesson_X.md to keep it organized.
    4. Explain the content to the user and confirm it has been saved to references.
  • Homework Assistance:
    1. Parse homework files (PDF via scripts/parse_pdf_gemini.py or DOCX via scripts/parse_docx.py).
    2. Identify the tasks/questions.
    3. Do not just give answers. Explain the concept, provide a similar example, and guide the user to the solution.
    4. Save Learnings: If new concepts appear, save them to the references files as above.

4. OCR & Translation

  • Image Translation: If user uploads an image (kanji/text), use native vision to read it, then provide:
    • Transcription (Kana/Kanji).
    • Reading (Romaji/Furigana).
    • Meaning (Translation).
  • Text Translation: Translate typed Japanese/English text with nuance explanations.

5. Quiz Mode

  • Vocab/Grammar Quiz: Test user on known or newly ingested material.

Usage Guidelines

  • Tone: Encouraging, patient, fun. (Jaksel/Relaxed style if requested).
  • Homework Ethics: Guide, don't just solve. Explain the why.
  • Parsing: Use the provided scripts for file handling.

Quick Actions

  • "Parsin ini dong": Use scripts to read attached PDF/DOCX.
  • "Bantuin PR ini": Read file, explain concepts, guide user.
  • "Artinya apa ini?": Translate text or attached image.

Resources

  • references/vocab.md: N5 Level Vocabulary lists.
  • references/grammar.md: Basic Grammar rules.
  • scripts/greet.py: Time-appropriate greeting.
  • scripts/parse_pdf.py: Extract text from PDF files.
  • scripts/parse_docx.py: Extract text from DOCX files.
Usage Guidance
This skill is plausibly a useful Japanese tutor, but it has several important mismatches you should consider before installing: - The PDF parser (scripts/parse_pdf_gemini.py) requires GEMINI_API_KEY and will upload user PDFs to Google Gemini. The skill metadata does NOT declare this env var or mention file uploads — ask the author to explicitly disclose the external endpoint and required credential. Only proceed if you’re comfortable having uploaded documents processed by an external API. - There is no install spec or dependency list. The code uses python packages (google.generativeai and python-docx). Confirm your environment has these packages or request an install specification from the author. - SKILL.md references parse_pdf.py while the repo contains parse_pdf_gemini.py — ask for clarification or an updated SKILL.md to ensure behavior matches documentation. - Persisting extracted content by appending to references/*.md is expected for a study aid, but review what gets saved if you care about exposing homework or private material. Recommended actions: request the author add GEMINI_API_KEY to requires.env and document the external upload behavior; provide a dependency/install spec (pip requirements or similar); and fix file name/documentation mismatches. If you cannot obtain those assurances, run the skill in a sandboxed environment or avoid uploading sensitive files.
Capability Analysis
Type: OpenClaw Skill Name: japanese-tutor Version: 1.0.2 The skill is classified as benign. While it performs file write operations (appending vocabulary/grammar to local markdown files) and network calls (uploading PDFs to Google Gemini API for OCR/analysis), these actions are explicitly described in `SKILL.md` and are directly aligned with the stated purpose of an 'Interactive Japanese learning assistant' that handles 'PDF/DOCX material parsing' and 'OCR translation'. The file writes are constrained to specific reference files within the skill's directory, and the network activity is for a core feature (`scripts/parse_pdf_gemini.py`). There is no evidence of intentional harmful behavior, data exfiltration of unrelated sensitive information, or malicious prompt injection attempts.
Capability Assessment
⚠ Purpose & Capability
The skill's stated purpose (Japanese tutoring, PDF/DOCX parsing, OCR) is coherent with the included scripts. However, the code requires access to a Gemini (Google) API key for PDF parsing (GEMINI_API_KEY) which is not listed in the skill's required environment variables or metadata. Also SKILL.md references scripts named parse_pdf.py while the repository contains parse_pdf_gemini.py — a mismatch suggesting sloppy metadata.
⚠ Instruction Scope
SKILL.md instructs the agent to parse uploaded PDFs/DOCX and to persist extracted vocabulary/grammar by appending to local reference files. That behavior is within the tutor purpose, but the instructions do not warn that PDFs are uploaded to an external (Gemini) API for processing. The runtime instructions therefore omit a material privacy/network detail the agent will perform.
⚠ Install Mechanism
There is no install specification even though code depends on external Python packages (google.generativeai in parse_pdf_gemini.py and python-docx used by parse_docx.py). The skill expects runtime libraries that may not be available, but provides no install or dependency list. This is an operational inconsistency (not direct code-maliciousness) but important to surface.
⚠ Credentials
The parse_pdf_gemini.py script reads GEMINI_API_KEY from the environment and uploads user files to Google’s Generative API. The skill metadata lists no required env vars or primary credential, so credential requirements are undeclared. Asking for an external API key (and uploading potentially sensitive user files) is proportionate to parsing only if explicitly declared and consented to; here it is not.
✓ Persistence & Privilege
The skill does not request elevated platform privileges or always:true. It intends to write to its own reference files (references/*.md), which is consistent with its stated 'Persist Knowledge' behavior. It does not modify other skills or global agent settings per the provided files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install japanese-tutor
  3. After installation, invoke the skill by name or use /japanese-tutor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Switched PDF parsing from scripts/parse_pdf.py to the new scripts/parse_pdf_gemini.py, enabling Gemini Vision OCR and layout analysis. - Removed the old parse_pdf.py script and added the new parse_pdf_gemini.py script. - Updated documentation to reflect the new PDF parsing approach using Gemini for study material and homework assistance.
v1.0.1
- Added lesson-specific reference support: new files like references/lesson_X.md now store materials by lesson. - Improved study helper: now saves newly extracted vocabulary and grammar to references for reuse. - Enhanced persistence: concepts from parsed study/homework materials are appended to relevant reference files. - Confirmations are given when new material is saved to references.
v1.0.0
- Initial release of the interactive Japanese learning assistant. - Supports vocabulary practice, grammar explanations, quizzes, and conversation roleplay. - Can parse and extract content from PDF/DOCX for study and homework help. - Offers OCR translation of Japanese text from images, with readings and meanings. - Provides ethical homework guidance—explains concepts and guides, rather than giving direct answers.
Metadata
Slug japanese-tutor
Version 1.0.2
License —
All-time Installs 5
Active Installs 5
Total Versions 3
Frequently Asked Questions

What is Japanese Tutor?

Interactive Japanese learning assistant. Supports vocabulary, grammar, quizzes, roleplay, PDF/DOCX material parsing for study/homework help, and OCR translation. It is an AI Agent Skill for Claude Code / OpenClaw, with 2603 downloads so far.

How do I install Japanese Tutor?

Run "/install japanese-tutor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Japanese Tutor free?

Yes, Japanese Tutor is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Japanese Tutor support?

Japanese Tutor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Japanese Tutor?

It is built and maintained by chndranndr (@chndranndr); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments