← 返回 Skills 市场
chndranndr

Japanese Tutor

作者 chndranndr · GitHub ↗ · v1.0.2
cross-platform ⚠ suspicious
2603
总下载
1
收藏
5
当前安装
3
版本数
在 OpenClaw 中安装
/install japanese-tutor
功能描述
Interactive Japanese learning assistant. Supports vocabulary, grammar, quizzes, roleplay, PDF/DOCX material parsing for study/homework help, and OCR translation.
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
⚠ 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.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install japanese-tutor
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /japanese-tutor 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
Slug japanese-tutor
版本 1.0.2
许可证 —
累计安装 5
当前安装数 5
历史版本数 3
常见问题

Japanese Tutor 是什么？

Interactive Japanese learning assistant. Supports vocabulary, grammar, quizzes, roleplay, PDF/DOCX material parsing for study/homework help, and OCR translation. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2603 次。

如何安装 Japanese Tutor？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install japanese-tutor」即可一键安装，无需额外配置。

Japanese Tutor 是免费的吗？

是的，Japanese Tutor 完全免费（开源免费），可自由下载、安装和使用。

Japanese Tutor 支持哪些平台？

Japanese Tutor 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Japanese Tutor？

由 chndranndr（@chndranndr）开发并维护，当前版本 v1.0.2。

推荐 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...
⬇ 463368 · 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.
⬇ 259467 · 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...
⬇ 200457 · 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.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 留言讨论