The book body draft to a just-before-publication levela 7-step revision coach that polishes it. It takes a draft written with book-chapter-writer and checks grammar·style·logic·quotation·length·visual materials·consistency in order. korean-spell-check (spelling) → book-revision-coach (revision) → korean-humanize (AI feel) → ai-slop-reviewer (final) The first stage of the 4-chain. After completing this skill, it immediately reaches a level that can be sent to a publishing house editor. What to fix (grammar·style·logic·quotation·length) is checked in 7 steps, and when to move on to the next chain is judged.
1. Overview
Revision is said to be **"70% of writing."** If revision is insufficient in a publishing body, the following risks occur.
| Risk | Impact |
|---|---|
| Grammar·spelling errors | Publishing house editor's first impression ↓, credibility damaged |
| Stylistic inconsistency | Reader immersion broken, AI feel strengthened |
| Logical leaps | Failure to convey the core message |
| Inaccurate quotations | Risk of copyright disputes |
| Runaway·insufficient length | Violation of publishing house format, possible rejection |
| Visual material inconsistency | Rework at the printing·design stage |
| Lack of consistency | Overall book completeness ↓ |
Only after passing the 7-step check in order is the just-before-publication level complete.
2. Trigger Keywords
Auto-invocation trigger (see frontmatter description). Slash invocation: /book-revision-coach.
3. Workflow (7-step check)
Step 1: Grammar·spelling first check
Check items
| Item | Standard |
|---|---|
| Spelling | National Institute of Korean Language Hangul spelling |
| Spacing | National Institute of Korean Language standard (particles·dependent nouns, etc.) |
| Foreign word notation | National Institute of Korean Language foreign word notation (e.g., "콘텐츠"·"앱"·"인터넷") |
| Sino-Korean·foreign word ratio | Native Korean first (convert Sino-Korean → native Korean when possible) |
| Ending consistency | Consistency of "~다" / "~합니다" within one work |
💡 This skill performs only the first check. For precise spelling,
moai-writer:korean-spell-check(BarunHangul) chaining is recommended.
Step 2: Style consistency check
Consistency of 4-genre style presets
Verify whether book-chapter-writer's 4-genre presets (§4) have been consistently applied throughout the body.
| Genre | Style verification points |
|---|---|
| Practical book | Tone friendly, encouraging, promising / short sentences / diagrams, checklists |
| Humanities, essays | Narrative, metaphor, stylistic consistency / varied sentence lengths |
| Technical books | Clarity, accuracy, code consistency / academic endings |
| Novels | Consistency of point of view and character speech style / description-centered |
Style violation detection
- If novel-style description suddenly appears in a practical book ⚠️
- If a code block suddenly appears in a humanities book ⚠️
- If the point of view suddenly shifts from first person → third person ⚠️
- If endings are mixed between "~da" → "~hamnida" ⚠️
Step 3: Logic flow check
Section-level flow
Check whether book-chapter-writer's 5-element structure (hook, body, climax, wrap-up, connection) was applied to every section.
| Check item | Pass criteria |
|---|---|
| Hook strength | The reader's attention is captured in the first 1-2 sentences |
| Body paragraph connection | Logical connectors and transition words between paragraphs are natural |
| Climax clarity | It is clear where the strongest message of a section is |
| One-line wrap-up summary | Summarize the key point in one line at the end of the section |
| Naturalness of the next connection | Arouses curiosity for the next section |
Chapter-level flow
Check whether book-outline-designer's 5-element synopsis was reflected in the chapter body.
| Check item | Pass criteria |
|---|---|
| Introductory pain point | The pain point is stated at the beginning of the chapter |
| Promise fulfillment | The body fulfills the "promise" part of the synopsis |
| 3 core claims | All 3 claims from the synopsis appear in the body |
| Cases and quotations cited | The synopsis cases are included in the body |
| Curiosity for the next chapter | A bridge from the end of the chapter to the next chapter |
Step 4: Quotation and footnote consistency check
Check citation formatting
| Citation type | Formatting consistency |
|---|---|
| Short quotation | Quotation marks + source specified |
| Long quotation (3 sentences or more) | Indentation + source |
| Statistics and data | In-text citation + footnote source |
| Interviews and remarks | Speaker + media + date |
| Internet sources | URL + access date |
Copyright check
- Verify fair use limits — Prohibition on quoting the entire core portion of a single work or single source
- Image and chart licenses — Verify CC BY, CC0, or self-produced
- Prohibition on citing external reference materials — Vault material citation guard
Footnote consistency
- Footnote numbering order, no duplicates
- Same sources cited in consolidated form (Ibid, op cit, or abbreviated)
- Every in-text footnote marker has a corresponding source at the end
Step 5: Length cleanup
Verify balance of section and chapter lengths
Compare book-outline-designer's length allocation with actual body length:
| Unit | Target length | Actual length | Deviation |
|---|---|---|---|
| 1 section | ___ 매 | ___ 매 | ±___% |
| 1장 | ___ 매 | ___ 매 | ±___% |
| 1부 | ___ 매 | ___ 매 | ±___% |
| Total | ___ 매 | ___ 매 | ±___% |
Within ±20% recommended. If exceeded, consider splitting or merging.
Handling length overflow/shortfall
- Overflow: A section exceeds 1.5x the standard → split the section
- Shortfall: A section is less than 0.5x the standard → merge with another section
- Chapter overflow: A chapter exceeds 1.5x the standard → split the chapter or move some sections to the next chapter
Step 6: Visual material check
Check placeholders for charts, code, and images
| Material | Placeholder check |
|---|---|
| Chart | [도표 X-Y. 도표 제목] In-text marker + attached file |
| Code | Specify code block language + indentation and line breaks |
| Figures/screenshots | [그림 X-Y] In-text marker + attachment |
| Infographic | [인포그래픽 X-Y] + design request |
| Exercise box | > **실습**: Format + length guide |
Visual material consistency
- Verify matching between in-text markers and attached materials
- Chart numbering order, no duplicates
- Visual material captions and descriptions clear
- Print resolution (DPI 300+ recommended)
Step 7: Final consistency check
6 consistency dimensions
| Dimension | Check |
|---|---|
| Ending | Consistency of "~da" / "~hamnida" |
| Point of view | Consistency of first person / third person / omniscient and limited (fiction) |
| Character | Consistency of character speech style and psychology (fiction) |
| Terminology | Use the same term for the same concept (technical and professional books) |
| Notation | Consistency of foreign word notation (e.g., unify "next.js" → "Next.js") |
| Length | Balance of average section and chapter lengths |
Consistency violation detection
Read the entire body once more from beginning to end and detect the following:
- A single word or term appears in two notations (e.g., "데이터" / "데이타")
- A single person or character appears with two speech styles
- Endings break consistency between sections or chapters
- Chart numbering order broken
4. Output format (revision report)
# 퇴고 보고서 — [가제·장 X]
## 입력 본문 정보
- 장: ___
- 꼭지 수: ___ 개
- 총 분량: ___ 매 (___자)
- 작성일: YYYY-MM-DD
## Step 1. 어법·맞춤법 1차 점검
| 항목 | 상태 | 비고 |
|------|:----:|------|
| 맞춤법 | ✅ / ⚠️ | ___ 건 (정밀 점검은 korean-spell-check) |
| 띄어쓰기 | ✅ / ⚠️ | ___ 건 |
| 외래어 표기 | ✅ / ⚠️ | ___ 건 (Next.js·콘텐츠 등) |
| 한자어·외래어 비율 | ✅ / ⚠️ | 우리말 우선 |
| 어미 일관성 | ✅ / ⚠️ | ___ |
## Step 2. 문체 일관성
- 장르 프리셋: ___ (실용·인문·기술·소설)
- 문체 위반 검출: ___ 건
- 권장 수정: ___
## Step 3. 논리 흐름
### 꼭지 단위 (5 요소 점검)
| 꼭지 | 훅 | 본문 | 클라이맥스 | 정리 | 연결 |
|------|:--:|:----:|:----------:|:----:|:----:|
| 1꼭지 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 2꼭지 | ⚠️ | ✅ | ⚠️ | ✅ | ✅ |
| ... |
### 장 단위 (시놉시스 5 요소 점검)
[장 시놉시스와 실제 본문 매칭 보고서]
## Step 4. 인용·각주 정합성
| 인용 # | 출처 명시 | 양식 정확 | 저작권 |
|--------|:--------:|:--------:|:-----:|
| 1 | ✅ | ✅ | ✅ |
| 2 | ⚠️ | ✅ | ✅ |
| ... |
- 각주 번호 정합성: ✅
- 외부 참고 자료 인용: 없음 ✅
## Step 5. 분량 정리
| 단위 | 목표 | 실제 | 편차 | 상태 |
|------|------|------|------|:----:|
| 1꼭지 | 4매 | 4.5매 | +12% | ✅ |
| 2꼭지 | 4매 | 7매 | +75% | ⚠️ (분리 권장) |
| 전체 장 | 16매 | 21매 | +31% | ⚠️ |
## Step 6. 시각 자료
| 자료 | 본문 표시 | 별첨 파일 | 캡션 | 인쇄 해상도 |
|------|:--------:|:--------:|:----:|:----------:|
| 도표 2-1 | ✅ | ✅ | ✅ | DPI 300 ✅ |
| 도표 2-2 | ✅ | ⚠️ (없음) | ✅ | — |
| 코드 블록 1 | ✅ | — | ✅ | — |
| ... |
## Step 7. 일관성 최종 점검
| 차원 | 위반 검출 | 권장 수정 |
|------|:--------:|----------|
| 어미 | 0건 | — |
| 시점 | 0건 | — |
| 인물 | 0건 | — |
| 용어 | 1건 | "데이타" → "데이터" 통일 |
| 표기 | 2건 | "next.js" → "Next.js" 통일 |
| 분량 | 1건 | 2꼭지 분리 |
## 퇴고 요약
- **점검 통과**: 5 / 7 단계
- **수정 필요**: Step 5·Step 7 (분량·용어)
- **우선순위 수정**:
1. 2꼭지 분량 폭주 → 2꼭지·2.5꼭지로 분리
2. 용어 통일 ("데이타" → "데이터", "next.js" → "Next.js")
- **다음 단계**: 수정 후 moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize 체이닝
5. Usage examples
Example 1 — Practical book (revision of Chapter 2 of a side-job book)
book-chapter-writer로 작성한 2장 초고 퇴고해줘.
2장은 4 꼭지·총 16매 분량 목표.
→ Step 1: First pass for grammar and spelling (2 issues detected, precise check by korean-spell-check)
→ Step 2: Practical book style consistency (friendly tone, short sentences) ✅
→ Step 3: 5-element check (2-item climax weak ⚠️)
→ Step 4: Verify sources for 5 citations ✅
→ Step 5: 2-item 7-page (runaway) → recommend splitting ⚠️
→ Step 6: No appendix for Table 2-2 ⚠️
→ Step 7: 1 terminology consistency issue ⚠️
→ Recommended revisions: 4, next step korean-humanize
Example 2 — IT primer (Next.js Chapter 1)
"Next.js App Router 첫 페이지" 1장 본문 퇴고.
→ Check technical writing style (clarity·precision)
→ Verify code block language specification·indentation
→ Terminology consistency (Next.js·App Router·Server Components notation)
→ Match figures·screenshots to body text + print resolution
Example 3 — Essay (Chapter 3, working mom in her 40s)
"새벽 5시 카페" 에세이 3장 퇴고.
→ Consistency of humanities style (narrative·metaphor)
→ Consistency of first-person point of view
→ Verify sources for quoted poetry·literary works
→ Length is free, but detect paragraphs that become too long
6. Korean Publishing Revision Conventions
From the perspective of a Korean publisher's editor
Revision signals a Korean publisher's editor looks at first:
- Sentence-ending consistency — mixing "~다" / "~합니다" is the most common rookie error
- Loanword orthography — standardize "next.js" vs "Next.js"
- Excessive Sino-Korean words — Sino-Korean words like "발휘", "재발 방지" → plain Korean
- Missing citation sources — immediately rejected if statistics·interview sources are missing
- Length variance — if section·chapter lengths are uneven, large-scale revisions at the editing stage
National Institute of Korean Language Core Language Norms
| Norm | Key contents |
|---|---|
| Hangul spelling | 1988 notification + recent amendments |
| Standard language regulations | Standard pronunciation rules·principles for standard language designation |
| Loanword transcription rules | English·Japanese·Chinese, etc. |
| Korean Romanization system | Hangul → Romanization |
Revision priorities (editor's perspective)
P1 (반려 위험): 인용 출처·저작권 누락, 분량 폭주
P2 (강력 수정): 어법·맞춤법 오류, 문체 비일관성, 용어 비일관성
P3 (편집 단계): 시각 자료 보완, 도표 디자인, 인쇄 해상도
7. Cautions
Avoiding revision pitfalls
| Pitfall | How to avoid it |
|---|---|
| Check everything in one revision pass | Do the 7 steps in order (focus on only 1-2 steps at a time) |
| Too familiar with one's own sentences | Re-read after some time (1 week later·read aloud) |
| Check spelling only | Grammar only on the first pass, detailed check with korean-spell-check |
| Ignore AI tells | moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize Chaining required |
| Leaving length variance unattended | Force split·merge if exceeding ±20% |
| Noncompliance with publisher's format | Check the target publisher's sentence-ending·style conventions in advance |
Recommended order of the review chain
초고 (book-chapter-writer)
↓
1차 어법·문체·논리 (book-revision-coach) ← 본 스킬
↓
정밀 맞춤법 (moai-writer:korean-spell-check, 바른한글)
↓
AI 슬롭 검수 (moai-coworker:ai-slop-reviewer) ← 필수
↓
AI 티 윤문 (moai-writer:korean-humanize) ← 필수
↓
출판사 투고용 제안서 (book-proposal-writer)
moai-coworker integration and fallback when not installed
The precision spelling, AI slop review, and AI-ness polishing stages of the above review chain are moai-coworker linked with plugin skills. If the moai-coworker plugin is installed korean-spell-check → ai-slop-reviewer → korean-humanize the chain is automatically linked. If not installed, follow this skill's own revision procedure — Polish to pre-publication level using only Step 1 (first-pass grammar), Step 2 (style consistency), and Step 7 (final consistency) checks and the in-text self-guidelines.
Source Policy
- Check items and criteria cite official sources from the National Institute of Korean Language and KPIPA
- Direct citation of reference materials outside the vault is prohibited
- Check tool recommendations prioritize tools available in the Korean market
8. Related Skills
Before (previous stage)
book-chapter-writer— Main draft (revision target)book-outline-designer— Synopsis (chapter-level check criteria)
After (chaining — regular chain)
moai-writer:korean-spell-check— Precision Korean spellingmoai-coworker:ai-slop-reviewer— AI slop review (required)moai-writer:korean-humanize— Precision AI-ness polishing (required)book-proposal-writer— After review completion, to publisher submission proposal
The revised completed main text is finished with the regular chain **
book-revision-coach → moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize**.
Alternative
moai-writer:korean-spell-checkStandalone — quick spelling onlymoai-coworker:ai-slop-reviewerStandalone — quick AI-ness detection only
9. Sources
External official sources (as of 2026)
| Material | URL | Purpose |
|---|---|---|
| National Institute of Korean Language Korean Orthography | https://www.korean.go.kr | Korean language norms |
| National Institute of Korean Language Foreign Word Transcription Rules | https://www.korean.go.kr | Foreign word and Romanization notation |
| Bareun Hangeul | (Pusan National University + Nara InfoTech) | Spelling check (uses korean-spell-check) |
| KPIPA | https://www.kpipa.or.kr | Publishing editing standards |
| Korea Publishing Contents KPC | https://www.kpc.or.kr | Editing and proofreading guide |
| Korea Copyright Commission | https://www.copyright.or.kr | Copyright and fair use |
Vault reference (concepts and frameworks only)
Extract insights related to "revision, proofreading, style, citation" from the GOOS Obsidian vault (applying the MECE principle of the 3 stages of insight derivation, transcription of the 6 methods of sentence collection, and Korean conversion of the 7 copywriting techniques). Do not use original metaphors or expressions as-is.
Version History
- v2.9.0 (2026-05-17): New skill introduced. moai-coworker plugin workflow No. 8 (last). 7-stage check (grammar, style, logic, citation, length, visual materials, consistency) + Korean publisher editor perspective + 4-chain review order.