SuperAPI AI Directory

book-revision-coach

General & other

View repository

Updated 10-15 21:02

About this skill

book-revision-coach

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:

  1. Sentence-ending consistency — mixing "~다" / "~합니다" is the most common rookie error
  2. Loanword orthography — standardize "next.js" vs "Next.js"
  3. Excessive Sino-Korean words — Sino-Korean words like "발휘", "재발 방지" → plain Korean
  4. Missing citation sources — immediately rejected if statistics·interview sources are missing
  5. 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 spelling
  • moai-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-check Standalone — quick spelling only
  • moai-coworker:ai-slop-reviewer Standalone — 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.