natural-japanese

Write, revise, and score natural Japanese business documents using deterministic lint detection.

Updated Sep 16, 2022
One-click install
npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill natural-japanese-ryuya-matsunawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: natural-japanese
Source: https://github.com/ryuya-matsunawa/dotfiles/tree/main/agents/.agents/skills/natural-japanese
Command: npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill natural-japanese-ryuya-matsunawa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sudachipy, sudachidict-core, torch, sentence-transformers, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Japanese text generated by AI often carries detectable habits—stock phrases, translationese, monotonous rhythm, uniform paragraph structure—that make documents read as machine-written. This Skill detects those patterns deterministically with lint scripts and guides a structured design-write-inspect-converge workflow to produce natural, readable Japanese business documents. ## Core Features & Use Cases - Deterministic AI-smell detection: Run lint.py to flag forbidden phrases, translationese, antithesis repetition, sentence-length uniformity, and lexical diversity issues, with corpus-calibrated thresholds and genre profiles (essay/tech/business). - Write and rewrite workflows: Draft or revise minutes, reports, guides, memos, slide outlines, and blog essays through a design → writing → inspection → convergence loop, with quick and full execution modes. - Diagnosis-only scoring: Score a document's naturalness from 0-100 without rewriting it, with band labels and top reasons, optionally including semantic embedding analysis. - Use Case: Paste a meeting-minutes draft and ask for a naturalness check; the Skill runs the linter, reviews structure and readability, and returns a revised version with a judgment ledger of what was changed or kept. ## Quick Start Ask the AI to rewrite the attached Japanese report so it reads naturally and does not sound AI-generated.

Frequently Asked Questions about natural-japanese

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if Japanese text sounds AI-generated?▼

Run the lint script with uv run scripts/lint.py --json on your Markdown file to detect forbidden phrases, translationese, and rhythm issues. For a 0-100 naturalness score without rewriting, use the score mode described in references/diagnose.md.

How to make AI-written Japanese sound more natural?▼

Follow the design-write-inspect-converge workflow: define reader and main message, write under the 12-rule writing constitution, then run lint and fix findings with a judgment ledger. Repeat until no new findings appear.

What Python dependencies does the Japanese lint script need?▼

The scripts require Python 3.10 or later with sudachipy and sudachidict-core for morphological analysis, declared as PEP 723 inline metadata. The optional semantic.py detector additionally needs torch and sentence-transformers with a roughly 1GB model download.

Can I use the lint checks without uv or Python available?▼

Yes, references/manual-checklist.md mirrors every lint detector as a manual review procedure for environments like Claude.ai where scripts cannot run. You check forbidden phrases, translationese, rhythm, and structure by eye using the same category names.

Does the linter support different Japanese writing genres?▼

Yes, pass --genre essay, tech, or business to switch to corpus-calibrated threshold profiles that reduce false positives for that genre. Business documents, for example, disable bullet-ratio and boilerplate-heading detectors since those conventions are legitimate there.

Why does the linter always exit with code 0?▼

It is a lint tool, not a CI gate, so detection counts never fail the run; only input errors like missing files return exit code 1. The design principle is that machines detect suspicious patterns while humans or AI decide whether to fix them.