К основному содержанию
скилл CX Codex

document-writing — скилл для Claude Code: что делает и как установить

Скилл document-writing для Claude Code задаёт агенту правила формального письма на английском, японском и традиционном китайском: структуру текста, регистр и оформление. Охватывает отчёты, статьи и деловые письма.

ISC 242 установок ★ 6 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add shino369/claude-code-personal-workspace --skill document-writing -a claude-code
Открыть на GitHub

Что делает document-writing

Скилл задаёт агенту правила письма для английского, японского и традиционного китайского. Сначала идут типы документов: научные статьи и тезисы, отчёты и служебные письма, техдокументация, эссе и обзоры. Дальше риторические схемы. В английском тезис стоит в начале, а каждый абзац открывается главной мыслью. В японском работает 起承転結 и выбор между である体 и です・ます体. В китайском — парные конструкции 對仗 и идиомы 成語.

Есть раздел про тон: разговорный и формальный регистр для каждого из трёх языков, с примерами лексики и грамматики. Оформление тоже разобрано: гарнитура и поля для английских работ, вертикальная 縦書き или горизонтальная 横書き запись для японских.

Скилл покрывает только одноязычное письмо. За перевод отвечает отдельный скилл translation-expertise, поэтому переводческую задачу этому не поручайте.

Какие задачи решает

  • собрать отчёт для руководства в формальном деловом тоне
  • поправить уровень вежливости в японском письме клиенту
  • перестроить английский абзац так, чтобы главная мысль шла первой
  • оформить китайский документ с парными конструкциями
  • развести разговорный и академический регистр внутри одного текста

Примеры запросов агенту

  • Напиши отчёт о тестировании на английском: тезис в первом абзаце, дальше доказательства.
  • Проверь японское письмо клиенту: нужен です・ます体, без фамильярности.
  • Сделай деловое предложение на традиционном китайском, 成語 только по делу.

Как установить document-writing

1Через Skills CLI (Vercel)

npx skills add shino369/claude-code-personal-workspace --skill document-writing -a claude-code

2Вручную: положить файлы

~/.claude/skills/document-writing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/document-writing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о document-writing

Как установить document-writing в Claude Code?

Выполните npx skills add shino369/claude-code-personal-workspace --skill document-writing -a claude-code. Файл скилла окажется по пути ~/.claude/skills/document-writing/SKILL.md.

Что делает document-writing?

Описывает конвенции формального письма на английском, японском и традиционном китайском: структуру абзацев, риторические схемы, регистр и оформление документа.

Скилл переводит тексты?

Нет, его область — одноязычное письмо. Для перевода в том же наборе есть translation-expertise.

Исходный текст

SKILL.md · ISC
---
name: document-writing
description: Expert knowledge in document and essay writing conventions for English, Japanese, and Chinese (Traditional). Use when writing or translating formal documents, essays, articles, reports, or professional communications. Provides language-specific writing styles, formatting conventions, and rhetorical patterns.
---

# 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

© shino369 · ISC · shino369/claude-code-personal-workspace

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
writing-guidelines vercel Скилл writing-guidelines для ревью документации и прозы по письменному гайдлайну. Возвращает замечания с номерами строк, чтобы правки не искать по всему файлу вручную. CX Codex +1 133 400установок writing-clearly-and-concisely davila7 Скилл writing-clearly-and-concisely для Claude, который заставляет агента писать прозу по правилам Странка и не скатываться в шаблонные обороты языковых моделей. CX Codex +1 206установок personal-chinese-writing-style sugarforever Скилл personal-chinese-writing-style держит китайский текст в одной типографике: кавычки, тире и многоточие по вашим правилам, без латинских запятых и точек между иероглифами. CX Codex +1 408установок writing-agent dongbeixiaohuo Плагин writing-agent организует пошаговый процесс написания статей на китайском языке. Сессию можно ставить на паузу и возвращаться к разбору промежуточных этапов. ★ 463звёзд репо tech-doc-style-chinese reason-machines Скилл tech-doc-style-chinese для Claude Code задаёт правила китайской технической документации: типографика, тон и линтер на Python. CX Codex +1 441установок technical-writing backnotprop Скилл technical-writing для Claude Code задаёт правила для документации, RFC, README и сообщений коммитов. Вызывается командой /technical-writing. CX Codex +1 10 700установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой