Skip to content

kgraph57/paper-writer-skill

paper-writer

Verified

Medical/scientific paper writing workflow skill. Manages the full pipeline from literature search to submission-ready manuscript. Creates and manages a project directory with IMRAD-format section files, literature matrix, reference management, and quality checklists. Supports both English and Japanese papers. Triggers: 'write paper', 'paper-write', 'start manuscript', '論文を書く', '論文執筆', '論文プロジェクト', 'manuscript', 'research paper', '原稿作成'.

FileKindSize
SKILL.mdskill md77.7 KB
examples/case-studies/discovery-to-draft.mdmarkdown5.3 KB
references/abstract-formats.mdmarkdown5.1 KB
references/adversarial-review.mdmarkdown21.6 KB
references/ai-disclosure.mdmarkdown6.4 KB
references/ai-for-science-model.mdmarkdown12.8 KB
references/citation-guide.mdmarkdown2.4 KB
references/citation-verification.mdmarkdown10.5 KB
references/clinical-trial-registration.mdmarkdown4.7 KB
references/coauthor-review.mdmarkdown14.2 KB
references/coi-detailed.mdmarkdown6.8 KB
references/desk-rejection-prevention.mdmarkdown6.1 KB
references/hook-compatibility.mdmarkdown6.1 KB
references/humanizer-academic.mdmarkdown12.0 KB
references/imrad-guide.mdmarkdown2.5 KB
references/journal-reformatting.mdmarkdown5.6 KB
references/journal-selection.mdmarkdown13.5 KB
references/keywords-guide.mdmarkdown4.6 KB
references/master-reference-list.mdmarkdown11.3 KB
references/multilingual-guide.mdmarkdown12.4 KB
references/novelty-check.mdmarkdown13.8 KB
references/open-access-guide.mdmarkdown4.6 KB
references/pubmed-query-builder.mdmarkdown16.7 KB
references/reporting-guidelines-full.mdmarkdown10.6 KB
references/reporting-guidelines.mdmarkdown3.2 KB
references/section-checklist.mdmarkdown4.5 KB
references/statistical-reporting-full.mdmarkdown8.6 KB
references/statistical-reporting.mdmarkdown22.5 KB
references/submission-portals.mdmarkdown4.1 KB
references/supplementary-materials.mdmarkdown3.9 KB
references/tables-figures-guide.mdmarkdown7.7 KB
references/word-count-limits.mdmarkdown4.6 KB
scripts/analysis-template.pyexecutablescript19.6 KB
scripts/compile-manuscript.shexecutablescript6.9 KB
scripts/forest-plot.pyexecutablescript16.9 KB
scripts/sr-dedup.pyexecutablescript12.5 KB
scripts/sr-pdf-link.pyexecutablescript6.8 KB
scripts/sr-prisma-count.pyexecutablescript8.7 KB
scripts/table1.pyexecutablescript9.7 KB
scripts/word-count.shexecutablescript12.8 KB
templates/abstract.mdmarkdown1.3 KB
templates/acknowledgments.mdmarkdown1.7 KB
templates/analysis-workflow.mdmarkdown5.1 KB
templates/case-abstract.mdmarkdown1.2 KB
templates/case-introduction.mdmarkdown1.7 KB
templates/case-report.mdmarkdown2.2 KB
templates/conclusion.mdmarkdown1.0 KB
templates/cover-letter.mdmarkdown1.3 KB
templates/data-management.mdmarkdown5.7 KB
templates/declarations.mdmarkdown6.1 KB
templates/discussion.mdmarkdown1.8 KB
templates/graphical-abstract.mdmarkdown2.7 KB
templates/highlights.mdmarkdown3.8 KB
templates/human-loop-ledger.mdmarkdown9.4 KB
templates/introduction.mdmarkdown1.8 KB
templates/limitations-guide.mdmarkdown6.2 KB
templates/literature-matrix.mdmarkdown1.2 KB
templates/methods.mdmarkdown1.9 KB
templates/preregistration.mdmarkdown19.5 KB
templates/project-init-case.mdmarkdown3.2 KB
templates/project-init.mdmarkdown3.6 KB
templates/proof-correction.mdmarkdown2.5 KB
templates/research-question.mdmarkdown18.6 KB
templates/response-to-reviewers.mdmarkdown12.5 KB
templates/results.mdmarkdown1.5 KB
templates/review-article.mdmarkdown11.6 KB
templates/revision-cover-letter.mdmarkdown10.3 KB
templates/sr-data-extraction.mdmarkdown9.2 KB
templates/sr-grade.mdmarkdown14.7 KB
templates/sr-outline.mdmarkdown13.5 KB
templates/sr-prisma-flow.mdmarkdown12.9 KB
templates/sr-prospero.mdmarkdown15.9 KB
templates/sr-rob.mdmarkdown18.3 KB
templates/sr-screening-pipeline.mdmarkdown12.1 KB
templates/study-design.mdmarkdown28.5 KB
templates/submission-ready.mdmarkdown2.5 KB
templates/title-page.mdmarkdown3.5 KB

references/multilingual-guide.md

View on GitHub
# Multilingual Paper Writing Guide (English + Japanese)

## Overview

This guide supports researchers writing papers in both English and Japanese, whether for international journals (English primary) or Japanese domestic journals (Japanese primary). It covers parallel writing workflows, translation strategies, and formatting conventions for both languages.

---

## Parallel Writing Workflow

### Strategy 1: English First, Then Japanese (Recommended for International Papers)

Best when targeting English-language journals with a Japanese abstract required.

```
Phase 1: Draft all sections in English
Phase 2: Internal review in English
Phase 3: Translate abstract and key sections to Japanese
Phase 4: Native check for Japanese sections
Phase 5: Final alignment check (both versions say the same thing)
```

### Strategy 2: Japanese First, Then English (For Japanese Journals or When Thinking in Japanese)

Best when the primary audience is Japanese, or when the author thinks more clearly in Japanese.

```
Phase 1: Draft all sections in Japanese
Phase 2: Internal review in Japanese
Phase 3: Translate to English (or have translated)
Phase 4: Native English check / professional editing
Phase 5: Final alignment check
```

### Strategy 3: Simultaneous Bilingual Drafting

Best for experienced bilingual writers. Write each section in your stronger language for that content type.

```
- Methods: Often easier in English (standard terminology)
- Discussion: May be easier in Japanese first (complex reasoning)
- Abstract: Write in primary language first, then translate
```

---

## Japanese Academic Writing Conventions

### Register: である調 (De aru Style)

Japanese academic papers use である調 (da/dearu style), NOT です・ます調 (desu/masu style).

| Context | Correct | Incorrect |
|---------|---------|-----------|
| Statement | ~である | ~です |
| Negative | ~ではない | ~ではありません |
| Past | ~であった / ~した | ~でした |
| Conjecture | ~と考えられる | ~と思います |
| Purpose | ~を目的とした | ~を目的としています |

### Common Academic Expressions

| English | Japanese Academic Expression |
|---------|------------------------------|
| We investigated... | ~について検討した |
| It is suggested that... | ~が示唆される |
| It has been reported that... | ~と報告されている |
| The purpose of this study was... | 本研究の目的は~であった |
| In conclusion... | 以上より~と結論される |
| There was a significant difference | 有意差を認めた(p < 0.05) |
| No significant difference was observed | 有意差は認められなかった |
| Further studies are needed | 今後さらなる検討が必要である |
| To the best of our knowledge | 我々の知る限り |
| The limitations of this study include | 本研究の限界として |

### 専門用語の英語併記 (English Annotation of Technical Terms)

When writing in Japanese, include the English term in parentheses at first use:

```
人工知能(artificial intelligence; AI)を用いた診断支援システムについて検討した。
深層学習(deep learning)モデルとして、畳み込みニューラルネットワーク
(convolutional neural network; CNN)を採用した。
```

Rules:
- First occurrence: full English term + abbreviation
- Subsequent occurrences: Japanese term or abbreviation only
- Well-known abbreviations (DNA, CT, MRI) may not need full expansion
- Journal-specific: check target journal's policy

---

## Common Translation Pitfalls

### 和文英訳 (Japanese to English) Common Errors

| Japanese Pattern | Wrong English | Correct English |
|-----------------|---------------|-----------------|
| ~が報告されている | It is reported | It has been reported / Previous studies have shown |
| 検討した | We examined | We investigated / We analyzed |
| 有用であると考えられた | It was thought to be useful | It appeared to be useful / The findings suggest utility |
| 著明な改善を認めた | We recognized remarkable improvement | Marked improvement was observed |
| 特に問題なく | Without particular problems | Without complications / Uneventfully |
| ~において | In ~ | Among / During / With regard to (context-dependent) |
| 症例を経験した | We experienced a case | We report a case / We encountered a case |
| 若干の知見を得た | We obtained some findings | Our findings suggest / We found |

### 英文和訳 (English to Japanese) Common Errors

| English Pattern | Wrong Japanese | Correct Japanese |
|----------------|----------------|------------------|
| Significantly | 著しく (meaning: remarkably) | 統計学的に有意に |
| We found that... | 我々は~を見つけた | ~であることが明らかとなった |
| Robust results | 頑丈な結果 | 頑健な結果 |
| This study demonstrates | この研究は実演する | 本研究は~を示した |
| State-of-the-art | 最先端の芸術 | 最先端の / 最新の |
| Address the issue | 問題に取り組む (too casual) | ~について検討する |

### Passive Voice Conventions

- English medical papers: Passive voice common and accepted ("Blood samples were collected")
- Japanese medical papers: Also uses passive/impersonal constructions ("採血を行った" rather than "我々は採血した")
- Avoid direct "we" (我々は) at the start of every sentence in Japanese

---

## Term Consistency Table Template

Maintain this table throughout the manuscript to ensure consistent terminology:

```markdown
| English Term | Japanese Term | Abbreviation | First Use Section | Notes |
|-------------|---------------|--------------|-------------------|-------|
| artificial intelligence | 人工知能 | AI | Introduction | |
| machine learning | 機械学習 | ML | Introduction | |
| deep learning | 深層学習 | DL | Methods | |
| convolutional neural network | 畳み込みニューラルネットワーク | CNN | Methods | |
| sensitivity | 感度 | Se | Results | NOT 敏感度 |
| specificity | 特異度 | Sp | Results | NOT 特殊性 |
| positive predictive value | 陽性的中率 | PPV | Results | |
| negative predictive value | 陰性的中率 | NPV | Results | |
| area under the curve | 曲線下面積 | AUC | Results | |
| confidence interval | 信頼区間 | CI | Results | |
| odds ratio | オッズ比 | OR | Results | |
| hazard ratio | ハザード比 | HR | Results | |
| informed consent | インフォームドコンセント | IC | Methods | 説明と同意 also used |
| institutional review board | 倫理委員会 | IRB | Methods | 施設内審査委員会 also used |
| retrospective study | 後ろ向き研究 | - | Methods | 後方視的研究 also used |
| prospective study | 前向き研究 | - | Methods | 前方視的研究 also used |
| [Add project-specific terms] | | | | |
```

---

## Section-by-Section Translation Checklist

### Title
- [ ] English title: concise, informative, no abbreviations
- [ ] Japanese title: matches English meaning exactly
- [ ] Both titles follow target journal format
- [ ] Running title provided if required (both languages)

### Abstract
- [ ] Structure matches (Background/Methods/Results/Conclusions)
- [ ] Word count within limits for both languages
- [ ] Numbers and statistics identical in both versions
- [ ] Key terms consistent with terminology table
- [ ] No information in one version that is absent from the other

### Introduction
- [ ] Same references cited in both versions
- [ ] Research question/objective stated identically
- [ ] Background context equivalent (not just translated word-for-word)

### Methods
- [ ] Statistical methods described identically
- [ ] Ethics approval statement present in both
- [ ] Technical terms match terminology table
- [ ] Study design terminology consistent

### Results
- [ ] All numerical values identical
- [ ] Table/figure references match
- [ ] Statistical values (p-values, CIs) identical
- [ ] No results in one version missing from the other

### Discussion
- [ ] Key arguments present in both versions
- [ ] Limitations section equivalent
- [ ] Future directions consistent
- [ ] Conclusion statements aligned

### References
- [ ] Same references in both versions
- [ ] Format follows respective journal guidelines
- [ ] Japanese references include English translation of title (if required)

---

## Translation Tools and Their Limitations

### DeepL
- **Strengths**: Generally best quality for Japanese-English medical text
- **Weaknesses**: May not handle highly specialized terminology correctly
- **Best practice**: Use as a starting draft, then manually review every sentence
- **Caution**: Do not submit AI-translated text without thorough human review

### Google Translate
- **Strengths**: Free, handles many language pairs
- **Weaknesses**: Often produces awkward medical Japanese; literal translations
- **Best practice**: Use only for rough understanding, not for manuscript text

### ChatGPT / Claude
- **Strengths**: Can maintain context across paragraphs; can follow style instructions
- **Weaknesses**: May hallucinate content not in the original; may "improve" the original
- **Best practice**: Provide the source text and ask for translation only, then verify
- **Critical rule**: Always verify that translated text says exactly what the original says

### Manual Review (Required for All Methods)
- Native or near-native speaker review is mandatory
- Focus on: medical terminology accuracy, register appropriateness, logical flow
- Consider professional medical translation services for high-impact publications

---

## Japanese Journal Formatting Differences

### Common Differences from International Journals

| Aspect | International (English) | Japanese Journals |
|--------|------------------------|-------------------|
| Author names | First Last | 姓 名 (Last First) |
| Affiliations | Department, Institution, City, Country | 施設名, 部門名 |
| Abstract | English only (usually) | Japanese + English (both required) |
| Keywords | English | Japanese + English |
| Figures/Tables | English captions | Japanese captions (sometimes bilingual) |
| References | Vancouver or APA style | Journal-specific (often modified Vancouver) |
| Page format | A4 or Letter, double-spaced | Often A4, specific margins |
| Word count | Word count | 文字数 (character count) |
| Ethics statement | IRB approval number | 倫理委員会承認番号 |

### Japanese Reference Formatting

For Japanese-language references:
```
著者名. 論文タイトル. 雑誌名. 発行年;巻(号):ページ.

Example:
田中太郎, 山田花子. 人工知能を用いた画像診断の現状と展望. 日本医学雑誌. 2024;150(3):234-241.
```

For English references cited in Japanese papers:
```
Author AA, Author BB. Title of the article. Journal Name. Year;Vol(Issue):Pages.
(Same as standard Vancouver format)
```

### Bilingual Abstract Format (Common in Japanese Journals)

```
【和文抄録】
目的:[研究目的]
方法:[研究方法]
結果:[主要結果]
結論:[結論]
キーワード:[キーワード1], [キーワード2], [キーワード3]

【英文抄録 / Abstract】
Objective: [Objective]
Methods: [Methods]
Results: [Results]
Conclusions: [Conclusions]
Keywords: [keyword1], [keyword2], [keyword3]
```

---

## Quick Reference: Common Medical Terms (English-Japanese)

| English | Japanese | Reading |
|---------|----------|---------|
| patient | 患者 | かんじゃ |
| diagnosis | 診断 | しんだん |
| treatment | 治療 | ちりょう |
| prognosis | 予後 | よご |
| complication | 合併症 | がっぺいしょう |
| adverse event | 有害事象 | ゆうがいじしょう |
| clinical trial | 臨床試験 | りんしょうしけん |
| randomized controlled trial | ランダム化比較試験 | - |
| systematic review | システマティックレビュー | - |
| meta-analysis | メタアナリシス / メタ解析 | - |
| cohort study | コホート研究 | - |
| case-control study | 症例対照研究 | しょうれいたいしょうけんきゅう |
| cross-sectional study | 横断研究 | おうだんけんきゅう |
| incidence | 発生率 / 罹患率 | はっせいりつ / りかんりつ |
| prevalence | 有病率 | ゆうびょうりつ |
| mortality | 死亡率 | しぼうりつ |
| morbidity | 罹患率 | りかんりつ |
| informed consent | インフォームドコンセント / 説明と同意 | - |
| standard deviation | 標準偏差 | ひょうじゅんへんさ |
| interquartile range | 四分位範囲 | しぶんいはんい |
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall