document-writing
npx skills add https://github.com/shino369/claude-code-personal-workspace --skill document-writing
Agent 安装分布
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-expertiseskill.
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:
- Introduction: Hook, background, thesis statement
- Body paragraphs: Topic sentence, evidence, analysis, transition
- 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
- Know Your Audience: Adapt language and tone to reader expectations
- Follow Conventions: Respect cultural writing traditions
- Be Clear and Concise: Avoid unnecessary complexity
- Use Examples: Concrete examples strengthen arguments
- Maintain Consistency: Keep tone, style, and formatting uniform
- Edit Ruthlessly: Good writing is rewriting
- Get Feedback: Have native speakers review when possible
- Read Extensively: Learn from well-written examples in target language
- Practice Regularly: Writing skills improve with practice
- 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