japanese-tech-writing

Enforces Japanese technical writing norms for drafting and revising technical documents.

3|Updated Jul 1, 2016
Ready to run
npx skills add https://github.com/shomatan/dotfiles --skill japanese-tech-writing-shomatan
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
Please help me install this Agent Skill.
Skill: japanese-tech-writing
Source: https://github.com/shomatan/dotfiles/tree/main/dot_claude/skills/japanese-tech-writing
Command: npx skills add https://github.com/shomatan/dotfiles --skill japanese-tech-writing-shomatan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Japanese technical manuscripts often suffer from weak paragraph logic, redundant phrasing, LLM-style filler expressions, and unnatural translation-influenced metaphors. This Skill provides a comprehensive style guide that governs how Japanese technical documents, book chapters, and articles should be written and revised. ## Core Features & Use Cases - Paragraph and Argumentation Rules: Enforces paragraph writing discipline, one-topic-per-paragraph structure, explicit logical connectors, and rigorous reasoning without logical gaps. - LLM Expression Detection: Prohibits hollow LLM-style phrases (e.g., empty emphasis, formulaic transitions) and translation-influenced metaphors like literal renderings of English idioms (carry, open, live in). - Redundancy Elimination: Removes repeated claims, decorative sentences, and unnecessary rhetorical devices while preserving necessary logical scaffolding. - Use Case: When drafting a chapter of a Japanese technical book or revising a draft article, apply these norms to produce prose with tight argumentation, controlled reader cognitive load, and natural Japanese phrasing. ## Quick Start Review and rewrite this Japanese technical draft according to the japanese-tech-writing style norms.

Frequently Asked Questions about japanese-tech-writing

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

FAQPage Schema
How do I improve Japanese technical writing style?โ–ผ

Apply paragraph writing discipline with one topic per paragraph, explicit logical connectors between paragraphs, and single-direction argumentation. Remove redundant restatements, hollow emphasis words, and translation-influenced metaphors while preserving necessary logical scaffolding.

What are common LLM-style phrases to avoid in Japanese writing?โ–ผ

Avoid empty announcements like "้‡่ฆใชใฎใฏใ€œใงใ‚ใ‚‹", formulaic transitions like "ใ€œใซใŠใ„ใฆ", hollow adjectives like "ไธๅฏๆฌ " or "ๅคš่ง’็š„", and vague verbs like "ๆŽ˜ใ‚Šไธ‹ใ’ใ‚‹" or "่จ€่ชžๅŒ–ใ™ใ‚‹" that add no substantive content to the argument.

How do I fix translation-influenced metaphors in Japanese text?โ–ผ

Identify expressions where English idioms were translated literally, such as "้ธๅฅฝใ‚’้‹ใถ" (carry) or "ๅ•ใ„ใŒ้–‹ใ‹ใ‚Œใฆใ„ใ‚‹" (open question). Rewrite them with concrete subjects and plain Japanese verbs, like "้ธๅฅฝใŒใƒ™ใ‚ฏใƒˆใƒซใจใ—ใฆ่กจ็พใ•ใ‚Œใ‚‹" or "ใพใ ็ญ”ใˆใŒๅ‡บใฆใ„ใชใ„".

When should hedging expressions be kept in technical writing?โ–ผ

Keep hedging expressions like "ใ‹ใ‚‚ใ—ใ‚Œใชใ„" or "ใ ใ‚ใ†" when they represent genuine uncertainty, unverified possibilities, character recognition, reader doubts, or counterfactuals. Remove them only when the claim is already established by evidence in the text.

What are the limitations of this writing style guide?โ–ผ

The guide targets Japanese technical prose such as book chapters, articles, and explanatory documents. It does not cover other languages, fiction writing, marketing copy, or document formatting concerns like layout and typography.