write-natural-japanese

Rewrites Japanese prose to remove source-language interference while preserving meaning, certainty, and terminology.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mtk177a/skills --skill write-natural-japanese-mtk177a
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-natural-japanese
Source: https://github.com/mtk177a/skills/tree/main/skills/write-natural-japanese
Command: npx skills add https://github.com/mtk177a/skills --skill write-natural-japanese-mtk177a

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Japanese drafts and translations often carry over foreign sentence structures, unnecessary English words, vague metaphors, and context-mismatched vocabulary. This Skill revises such prose into natural Japanese without altering the facts, claims, confidence levels, or established technical terms in the original text. ## Core Features & Use Cases - Source-language interference removal: Detects and restructures nominalizations, word order, and word-for-word correspondences inherited from other languages. - Context-aware wording decisions: Uses a reference guide to decide whether flagged expressions like 「契約」, 「ゲート」, 「正本」, or deterministic should be kept, concretized, or rephrased based on their actual meaning in context. - Meaning and terminology preservation: Maintains formal names, identifiers, code, quotations, established technical terms, and stated uncertainty levels throughout revision. - Use Case: Translating an English technical explanation containing phrases like "API contract" and "silently fails" into natural Japanese, where each expression is rendered according to its stated role rather than mechanically mapped to a fixed Japanese label. ## Quick Start Rewrite this Japanese technical note into natural Japanese without changing its meaning, conditions, or established terminology.

Frequently Asked Questions about write-natural-japanese

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

FAQPage Schema
How do I make Japanese technical writing sound more natural?▼

Identify source-language interference such as English nominalization, word-for-word correspondences, and unnecessary English generalities, then reconstruct sentences around what actually happens. Preserve code, identifiers, formal product names, and established technical terms while replacing vague metaphors with concrete descriptions of behavior, conditions, and results.

How should I translate English terms like API contract or source of truth into Japanese?▼

Translate each expression according to its stated role in context rather than applying fixed Japanese labels. For example, render a generic API contract as the specific output requirement or compatibility condition it represents, and keep formally defined terms like DeployGuard Quality Gate unchanged.

When should I not use this Japanese writing Skill?▼

Do not use it for ordinary Japanese responses during coding or Q&A, mechanical proofreading of typos and punctuation, editing that only concerns document structure or argumentation, or detecting AI-generated text. It applies only when natural Japanese prose is the primary deliverable.

Does rewriting Japanese text risk changing technical meaning?▼

The Skill explicitly forbids changing facts, claims, reasoning, certainty levels, or scope for the sake of naturalness. When naturalness conflicts with technical accuracy, accuracy is preserved and supplementary explanation is added instead.

Are words like 契約 or ゲート banned in Japanese technical writing?▼

No, the wording reference is not a banned-word list. Each flagged expression is evaluated in context: established terms like contract testing and Quality Gate are kept, while generic uses are concretized into the actual requirement, check, approval, or control they represent.