SuperAPI AI Directory

document-writing

Writing & research

View repository

Updated 10-15 17:15

About this skill

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 (References)

Typography:

  • Traditional characters (Traditional characters)
  • Proper punctuation (。、「」《》)
  • Appropriate spacing
  • Section numbering (one, two, three or 1, 2, 3)
  • Paragraph indentation (first-line 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: Introduction, Development, Twist, Conclusion Structure Example

Topic: The value of remote work (The value of remote work)

In recent years, remote work has been attracting attention as part of work style reform. (Introduction)

Under conventional office work, commuting time and fixed working hours constrained employees' lives. In addition, companies also bore large costs for maintaining large-scale office space. (Development)

However, with the introduction of remote work, this situation changed completely. Employees were able to work from home or any place they liked, and were freed from the stress of commuting. Companies became able to hire excellent talent regardless of region, and organizational competitiveness improved. (Twist)

In this way, remote work is not merely an option for how to work, but has the potential to change values across society as a whole. (Conclusion)

Analysis:

  • Introduction (ki): Introduces remote work as part of work reform trend
  • Development (shou): Develops context by describing traditional office problems
  • Twist (ten): Presents turning point with remote work's transformative impact
  • Conclusion (ketsu): Concludes with broader implication about societal values
  • Indirect, gradual build to conclusion
  • Uses passive voice (attention is being drawn, was freed)
  • Formal academic tone with dearu style

Chinese: Balanced Structure with Idiom Example

Topic: Advantages of remote work (Advantages of remote work)

With technology changing rapidly, remote work has become a trend that modern companies cannot ignore. This way of working not only saves costs for companies, but also brings unprecedented convenience to employees. On one hand, companies do not need to bear huge office space costs, achieving more with less; on the other hand, employees are freed from the hardship of commuting and can complete work at home, achieving the best of both worlds. From this we can see that remote work for companies and employees is truly mutually beneficial and enhances each other. In summary, remote work is not only an innovation in working methods, but also an important path to improving quality of life.

Analysis:

  • Uses idioms naturally: changing rapidly (rapid change), achieving more with less (achieve more with less), best of both worlds (best of both worlds), mutually beneficial (mutually beneficial)
  • Parallel structure: on one hand...on the other hand (on one hand...on the other hand)
  • Classical phrases: from this we can see (from this we can see), in summary (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 (on the other hand), in contrast to that (in contrast to that) Chinese: in comparison (in comparison), on the contrary (on the contrary)

Cause and Effect

English: Because, therefore, as a result, consequently Japanese: ...because, ...since, as a result, therefore Chinese: because...therefore, therefore, due to, lead to

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 introduction, development, twist, conclusion or structure
  • Chinese: Effective use of idioms 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 (Japanese Writing Proficiency Test) materials
  • Bunshō dokuhon (Bunshō dokuhon) by various authors
  • Academic writing guides from Japanese universities

Chinese Writing:

  • Modern Chinese Rhetoric (Modern Chinese Rhetoric)
  • Practical Writing
  • Style guides from Taiwan Ministry of Education