natural-japanese

Detects and removes AI-sounding patterns from Japanese business documents using deterministic lint scripts.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill natural-japanese-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: natural-japanese
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/natural-japanese
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill natural-japanese-pikachu0310

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 written by AI often carries detectable habits—stock phrases, translationese, monotonous rhythm, uniform paragraph structure—that make documents read as machine-generated. This Skill finds those patterns mechanically and guides a structured rewrite so business documents read naturally. ## Core Features & Use Cases - Deterministic lint detection: scripts/lint.py flags forbidden phrases, translationese, antithesis repetition, sentence-length uniformity, lexical diversity, and low specificity, with genre profiles for essay, tech, and business writing. - Structured writing workflow: A four-phase process (design, write, inspect, converge) with quick and full modes, covering minutes, reports, guides, memos, slide outlines, blog posts, and essays. - Diagnosis-only scoring: The score mode returns a 0-100 naturalness score with reasons and fix priorities without rewriting the document. - Use Case: Paste a meeting-minutes draft and ask for a naturalness check; the Skill runs lint, reviews structure and readability, and iterates revisions until no new findings appear. ## Quick Start Ask the AI to rewrite the attached Japanese report so it reads naturally and does not sound AI-generated, using quick mode.

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 score mode, which executes lint.py against the document and returns a 0-100 naturalness score with the top reasons and fix priorities. Quick mode uses lint only; full mode adds structure and readability reviews.

How do I make AI-written Japanese sound more natural?

Use the write mode, which follows a design, write, inspect, converge loop. The lint script flags forbidden phrases, translationese, and monotonous rhythm, and each finding is judged in context before rewriting.

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, runnable via uv. The optional semantic.py detector additionally needs torch and sentence-transformers with a roughly 1GB model download.

Can I use this in environments without uv or Python?

Yes. references/manual-checklist.md mirrors every lint detector as a manual review procedure, so environments like Claude.ai can apply the same checks by eye without running scripts.

Does the lint work differently for essays versus business documents?

Yes. The --genre flag switches to corpus-calibrated threshold profiles for essay, tech, and business genres, relaxing rules where human writers legitimately use bullet lists, bold emphasis, or longer sentences.

Why does the lint exit with code 0 even when it finds problems?

It is a lint, not a CI gate: findings are suspicions for a human or AI to judge, not automatic failures. Only input errors such as missing files return exit code 1.