document-writing

SKILL.md

Document and Essay Writing

Scope: This skill focuses on monolingual writing conventions for English, Japanese, and Traditional Chinese. For translation workflows, see the translation-expertise skill.

Overview

This skill provides comprehensive guidance on writing conventions, styles, and best practices for formal documents and essays in English, Japanese, and Traditional Chinese. Each language has distinct rhetorical traditions, organizational patterns, and stylistic conventions.

Document Types and Purposes

Academic Writing

  • Research papers
  • Theses and dissertations
  • Literature reviews
  • Conference papers
  • Journal articles

Business Documents

  • Reports and proposals
  • Memos and emails
  • Presentations
  • White papers
  • Case studies

Technical Writing

  • User manuals
  • API documentation
  • Technical specifications
  • Standard Operating Procedures (SOPs)
  • Technical reports

Creative and Editorial

  • Essays and articles
  • Blog posts
  • Opinion pieces
  • Feature stories
  • Book reviews

Language-Specific Writing Conventions

English Writing Style

Rhetorical Structure:

  • Deductive approach: State thesis upfront, then provide supporting evidence
  • Topic sentences: Each paragraph begins with main point
  • Explicit transitions: Use clear connectors (however, therefore, moreover)
  • Active voice preference: Direct and clear subject-verb-object
  • Conclusion restates thesis: Summarize arguments and restate main point

Organization Patterns:

  1. Introduction: Hook, background, thesis statement
  2. Body paragraphs: Topic sentence, evidence, analysis, transition
  3. Conclusion: Summary, restatement, broader implications

Stylistic Features:

  • Vary sentence length and structure
  • Use specific examples and evidence
  • Balance complex and simple sentences
  • Avoid redundancy and wordiness
  • Maintain parallel structure in lists

Common Phrases:

  • "It is worth noting that..."
  • "In this regard..."
  • "As previously mentioned..."
  • "To illustrate this point..."
  • "In conclusion..."

Japanese Writing Style (日本語)

Rhetorical Structure:

  • Inductive approach (起承転結): Build to conclusion gradually
    • 起 (ki): Introduction, set the scene
    • 承 (shou): Development, elaborate on introduction
    • 転 (ten): Twist or turn, present new perspective
    • 結 (ketsu): Conclusion, resolve and conclude
  • Implicit conclusions: Reader expected to infer meaning
  • Emphasis on harmony: Avoid confrontational statements
  • Humble self-reference: Use humble forms when referring to own work

Politeness Levels:

  • Academic: である・だ体 (plain form) for formal academic writing
  • Business: です・ます体 (polite form) for business communication
  • Formal reports: Mix of である体 with occasional です・ます体

Stylistic Features:

  • Use of 漢語 (kango - Sino-Japanese compounds) for formal tone
  • Passive voice (受身形) more common than English
  • Nominalization (〜こと、〜の) to express abstract concepts
  • Four-character compounds (四字熟語) for conciseness
  • Indirect expressions to soften statements

Common Phrases:

  • 本稿では... (In this paper...)
  • ...について述べる (will discuss...)
  • ...と考えられる (it is thought that...)
  • ...ということが分かる (it can be understood that...)
  • 以上のことから... (From the above...)
  • 結論として... (In conclusion...)

Paragraph Structure:

  • Longer paragraphs than English
  • Less explicit topic sentences
  • Gradual development of ideas
  • Implicit logical connections

Traditional Chinese Writing Style (繁體中文)

Rhetorical Structure:

  • Classical influence: Influenced by literary Chinese traditions
  • Balance and parallelism (對仗): Symmetrical sentence structures
  • Four-character idioms (成語): Concise expression of complex ideas
  • Circular reasoning: Return to opening theme in conclusion
  • Emphasis on elegance: Refined language and literary allusions

Formality Levels:

  • Academic: Literary Chinese influence, classical structures
  • Business: Modern vernacular with formal vocabulary
  • Technical: Clear and direct, less literary

Stylistic Features:

  • Use of 成語 (chengyu) for sophisticated expression
  • Parallel structures (對偶句) for emphasis
  • Classical allusions (典故) to demonstrate erudition
  • Rhetorical questions for persuasion
  • Four-six parallel prose (駢文) for formal writing

Common Phrases:

  • 本文將探討... (This article will explore...)
  • 由此可見... (From this we can see...)
  • 綜上所述... (In summary...)
  • 值得注意的是... (It is worth noting that...)
  • 基於以上分析... (Based on the above analysis...)
  • 總而言之... (In conclusion...)

Paragraph Structure:

  • Balanced sentence structures
  • Use of parallel constructions
  • Integration of 成語 for conciseness
  • Smooth transitions using classical phrases

Tone and Register

Casual Tone

English:

  • Contractions (don't, won't, it's)
  • Conversational language
  • Personal pronouns (I, you, we)
  • Simple vocabulary
  • Short sentences
  • Informal expressions

Japanese:

  • Plain form verbs (食べる、行く)
  • Casual particles (ね、よ、さ)
  • Informal pronouns (僕、俺、君)
  • Sentence-ending だ
  • Casual expressions (すごい、ちょっと)

Chinese:

  • Colloquial expressions (很酷、超棒)
  • Simplified sentence structures
  • Everyday vocabulary (吃、看、玩)
  • Personal narrative style
  • Conversational phrases (你知道嗎?、對吧?)

Formal Tone

English:

  • No contractions (do not, will not, it is)
  • Academic/professional vocabulary
  • Third-person perspective preferred
  • Complex sentence structures
  • Passive voice when appropriate
  • Objective language

Japanese:

  • である/だ体 (academic plain)
  • です・ます体 (polite business)
  • Formal vocabulary (漢語)
  • Respectful expressions (敬語)
  • Impersonal constructions
  • Passive and potential forms

Chinese:

  • Literary vocabulary
  • Complex sentence structures
  • Use of 成語 and classical phrases
  • Formal connectors (然而、因此、即)
  • Third-person or impersonal constructions
  • Honorific expressions (敬語: 貴、本、敝)

Document Formatting Conventions

English Documents

Structure:

  • Title (centered, title case)
  • Author name(s) and affiliation
  • Abstract (if academic)
  • Introduction with clear thesis
  • Body with section headings
  • Conclusion
  • References (APA, MLA, Chicago, etc.)

Typography:

  • 12pt Times New Roman or similar
  • Double-spaced (academic)
  • 1-inch margins
  • Page numbers
  • Indented paragraphs or block style

Japanese Documents

Structure:

  • Title (中央揃え)
  • Author (著者名)
  • Abstract (要旨/概要)
  • 序論 (Introduction)
  • 本論 (Main body)
  • 結論 (Conclusion)
  • 参考文献 (References)

Typography:

  • Vertical writing (縦書き) for traditional essays
  • Horizontal writing (横書き) for academic/technical
  • Appropriate use of kanji, hiragana, katakana
  • Proper punctuation (。、「」)
  • Line breaks and paragraph spacing

Traditional Chinese Documents

Structure:

  • 標題 (Title, centered)
  • 作者 (Author)
  • 摘要 (Abstract)
  • 前言/緒論 (Introduction)
  • 內容/本文 (Main body)
  • 結論 (Conclusion)
  • 參考文獻 (References)

Typography:

  • Traditional characters (繁體字)
  • Proper punctuation (。、「」《》)
  • Appropriate spacing
  • Section numbering (一、二、三 or 1、2、3)
  • Paragraph indentation (首行縮排)

Concrete Writing Examples

This section demonstrates how rhetorical structures manifest in actual writing.

English: Deductive Approach Example

Topic: The benefits of remote work

Remote work has become increasingly valuable for modern organizations. First, it reduces overhead costs associated with maintaining physical office spaces, including rent, utilities, and equipment. Second, remote work expands the talent pool by removing geographic constraints, allowing companies to hire the best candidates regardless of location. Third, studies show that remote workers often report higher job satisfaction and productivity due to increased flexibility and reduced commute stress. These factors combine to make remote work an attractive option for both employers and employees.

Analysis:

  • Clear topic sentence stating the main point
  • Three supporting points with explicit markers (First, Second, Third)
  • Each point includes evidence or explanation
  • Concluding sentence ties ideas together
  • Direct, explicit communication style

Japanese: 起承転結 Structure Example

Topic: リモートワークの価値 (The value of remote work)

近年、働き方改革の一環として、リモートワークが注目を集めている。(起)

従来のオフィス勤務では、通勤時間や固定的な勤務時間により、社員の生活が制約されていた。また、企業側も大規模なオフィススペースの維持に多額のコストを負担していた。(承)

しかし、リモートワークの導入により、このような状況が一変した。社員は自宅や好きな場所で働くことができ、通勤のストレスから解放された。企業は優秀な人材を地域に関係なく採用できるようになり、組織の競争力が向上した。(転)

このように、リモートワークは単なる働き方の選択肢ではなく、社会全体の価値観を変える可能性を秘めている。(結)

Analysis:

  • 起 (ki): Introduces remote work as part of work reform trend
  • 承 (shou): Develops context by describing traditional office problems
  • 転 (ten): Presents turning point with remote work's transformative impact
  • 結 (ketsu): Concludes with broader implication about societal values
  • Indirect, gradual build to conclusion
  • Uses passive voice (注目を集めている、解放された)
  • Formal academic tone with である体

Chinese: Balanced Structure with 成語 Example

Topic: 遠程辦公的優勢 (Advantages of remote work)

隨著科技日新月異,遠程辦公已成為現代企業不可忽視的趨勢。此種工作模式不僅能為企業節省成本,更能為員工帶來前所未有的便利。一方面,企業無需負擔龐大的辦公場地費用,可謂事半功倍;另一方面,員工得以免除通勤之苦,在家中即可完成工作,可謂兩全其美。由此可見,遠程辦公之於企業與員工,實為互惠互利、相得益彰之舉。綜上所述,遠程辦公不僅是工作方式的革新,更是提升生活品質的重要途徑。

Analysis:

  • Uses 成語 naturally: 日新月異 (rapid change), 事半功倍 (achieve more with less), 兩全其美 (best of both worlds), 相得益彰 (mutually beneficial)
  • Parallel structure: 一方面...另一方面 (on one hand...on the other hand)
  • Classical phrases: 由此可見 (from this we can see), 綜上所述 (in summary)
  • Balanced, elegant expression
  • Formal literary style with refined vocabulary

Common Writing Patterns

Compare and Contrast

English: Clear comparison markers (similarly, in contrast, whereas, while) Japanese: 一方で (on the other hand), それに対して (in contrast to that) Chinese: 相較之下 (in comparison), 與此相反 (on the contrary)

Cause and Effect

English: Because, therefore, as a result, consequently Japanese: ...ので、...から、その結果、したがって Chinese: 因為...所以、因此、由於、導致

Problem-Solution

English: State problem clearly, propose solution, evaluate effectiveness Japanese: Build context, present challenge, suggest approach indirectly Chinese: Describe situation, analyze causes, propose countermeasures

Argumentation

English: Claim + evidence + reasoning + counterargument + rebuttal Japanese: Present multiple viewpoints, subtle persuasion, indirect conclusion Chinese: Cite authorities, use historical examples, logical progression

Quality Checklist

Before finalizing any document:

Content:

  • Clear purpose and thesis
  • Logical organization
  • Adequate evidence and support
  • Appropriate depth and scope
  • Effective introduction and conclusion

Style:

  • Consistent tone and register
  • Appropriate formality level
  • Language-specific conventions followed
  • Clear and concise expression
  • Engaging and readable

Technical:

  • Correct grammar and syntax
  • Proper punctuation
  • Accurate spelling
  • Correct character usage (JA/ZH)
  • Formatting consistency

Language-Specific:

  • English: Clear thesis, strong topic sentences
  • Japanese: Appropriate 起承転結 or structure
  • Chinese: Effective use of 成語 and formal expressions

Best Practices

  1. Know Your Audience: Adapt language and tone to reader expectations
  2. Follow Conventions: Respect cultural writing traditions
  3. Be Clear and Concise: Avoid unnecessary complexity
  4. Use Examples: Concrete examples strengthen arguments
  5. Maintain Consistency: Keep tone, style, and formatting uniform
  6. Edit Ruthlessly: Good writing is rewriting
  7. Get Feedback: Have native speakers review when possible
  8. Read Extensively: Learn from well-written examples in target language
  9. Practice Regularly: Writing skills improve with practice
  10. Respect Cultural Norms: Different cultures have different expectations

Resources

English Writing:

  • Strunk & White's "Elements of Style"
  • Purdue OWL (Online Writing Lab)
  • Chicago Manual of Style

Japanese Writing:

  • 日本語文章能力検定 (Japanese Writing Proficiency Test) materials
  • 文章読本 (Bunshō dokuhon) by various authors
  • Academic writing guides from Japanese universities

Chinese Writing:

  • 現代漢語修辭 (Modern Chinese Rhetoric)
  • 應用文寫作 (Practical Writing)
  • Style guides from Taiwan Ministry of Education
Weekly Installs
61
GitHub Stars
1
First Seen
Jan 22, 2026
Installed on
opencode57
codex55
gemini-cli55
cursor54
github-copilot50
amp48