SuperAPI AI Directory

book-chapter-writer

Design & creation

View repository

Updated 10-15 21:36

About this skill

book-chapter-writer

The book body in section units from beginning to end with completeness is a skill for writing. Takes the chapter synopsis from book-outline-designer (5 elements: introduction, promise, body summary, examples, connection) as input and writes while precisely matching the 200-character manuscript paper length. Automatic style branching by 4 genres (practical, humanities, technical, novel). Publishing standard length, citation format, diagram placeholders, code blocksare handled together to generate a first draft at a level that can be handed directly to a publisher's editor. In one section, what to convey (core message) is decided first, and when to place examples is designed.

1. Overview

Body writing proceeds in section units(3-10 pages for practical/technical books, 200-character manuscript paper). One section must have the following 5 elements to ensure completeness:

Element Length proportion Role
훅 (Hook) 10% Capture the reader's attention with the first sentence and first paragraph
Body 70% Core argument, examples, evidence
Climax 10% The most powerful citation, conclusion, insight
Closing 5% One-line summary, actionable suggestion
Next connection 5% Arouse curiosity toward the next section or chapter

200-character manuscript paper standard — the criterion publishers use to gauge length. Word count ÷ 4 ≈ page count.

2. Trigger Keywords

Auto-invocation trigger (see frontmatter description). Slash invocation: /book-chapter-writer.

3. Workflow (4 steps)

Step 1: Expand the section synopsis

Select 1 section to write from the chapter-level synopsis of book-outline-designer. Confirm the following with AskUserQuestion:

Item Question
Section position Which chapter and which section? (e.g., "Chapter 2, Section 3")
Target length Page count (e.g., 4 pages, 800 characters)
One-line topic The one sentence this section will cover
Persona point of view Which persona will be assumed for writing?
Citations and materials Organize in advance the materials, diagrams, and code to be cited

Step 2: Write the 5-element skeleton

Break down the expanded synopsis into a 5-element skeleton:

[훅] (1~2 문장)
[훅에서 본문 도입으로 자연스러운 다리]

[본문 단락 1] (핵심 주장 1)
- 근거 1
- 사례·인용 1

[본문 단락 2] (핵심 주장 2)
- 근거 2
- 사례·인용 2

[본문 단락 3] (핵심 주장 3 — 선택)
- 근거 3
- 사례·인용 3

[클라이맥스] (가장 강력한 통찰·인용·결론)

[정리] (한 줄 요약 + 실천 제안)

[다음 연결] (다음 꼭지·장 예고)

Step 3: Apply the 4 genre styles

Automatically apply the style preset for each genre. See §4 for detailed branching.

Step 4: Handle length count, citations, and diagrams

Length count (200-character manuscript paper)

  • Word count ÷ 4 ≈ page count
  • Example: 4 pages = about 800 characters (including spaces) or 1,600 characters (excluding spaces)
  • May vary by publisher (confirmation needed)

Handling quotes and footnotes

Quote type Notation
Short quote (1-2 sentences) Quotation marks ("…")
Long quote (3 or more sentences) Indented quote paragraph + source
Statistics and data In-text quote + source in footnote
Interview and remarks Specify speaker + outlet + date
Internet sources Access date + URL footnote

Placeholder for tables, code, and images

Material Placeholder
Table [도표 X-Y. 도표 제목] (X=chapter, Y=number)
Code ```language ... ``` (description)
Screenshot [그림 X-Y. 그림 제목]
Infographic [인포그래픽 X-Y]
Exercise box > **실습**: …
Checklist - [ ] 항목

4. 4 Genre style presets (automatic branching)

4-1. Practical books and self-help

Dimension Branch
Style Clarity, practicality, promise-centered
Ending "~da" and "~hamnida" may be mixed (varies by publisher)
Sentence length Short (average 30-50 characters)
Paragraph length 3-5 sentences
Examples Specify concrete numbers, periods, and results
Visual materials Tables, checklists, exercise boxes (2-4 per section)
Tone Friendly and encouraging tone (teacher to student)

Hook example patterns:

  • Question type: "Have you ever tried ○○?"
  • Statistic type: "70% of Korean office workers ___"
  • Scenario type: "If you found ___ this morning…"

4-2. Humanities, general interest, essays

Dimension Branch
Style Narrative, style-centered, use of metaphor
Ending Author's individuality (~ida, ~da, ~mnida free)
Sentence length Varied (alternating short and long sentences)
Paragraph length 5-10 sentences
Examples Everyday observations, literary quotations, historical examples
Visual materials Few (photos and illustrations only)
Tone Contemplative, confessional, warm

Hook example patterns:

  • Scene description: "One day in ___, I ___"
  • Quote introduction: "Writer ○○○ said this…"
  • Question introduction: "Why do people ___?"

4-3. Technical and professional books, IT introductory books

Dimension Branch
Style Clear, precise, use of technical terms
Ending Consistent "~da" (academic)
Sentence length Clearly (average 30-60 characters)
Paragraph length 3-7 sentences (paragraph per concept)
Examples Code examples, diagrams, hands-on steps
Visual materials Very rich (3-6 per section)
Tone Friendly fellow developer tone (introductory book) / precise expert (advanced)

Hook example patterns:

  • Problem definition: "A problem you often encounter when building ___ is…"
  • Code introduction: "Let's look at the following code."
  • Result promise: "By the end of this section, you will be able to ___."

4-4. Fiction and literature

Dimension Branch
Style Consistency of description, point of view, and style
Point of view First person/third person, omniscient/limited (consistent throughout the chapter)
Endings Author's individuality
Sentence length Varied (depending on the scene and the character's psychology)
Paragraph length Variable (alternating dialogue, description, and narration)
Characters Consistency of actions, speech style, and psychology
Visual materials None (text-oriented)
Tone Consistent with the work's worldview

Hook example patterns:

  • Scene introduction: "That day's ___ was like ___."
  • Dialogue introduction: "'○○○.' ___ said."
  • Inner thoughts introduction: "I ___ ___ ."

5. Output format (section body)

# [장 X. 장 제목] / [꼭지 Y. 꼭지 제목]

(메타: ___ 매·___자·___ 시간 추정 독서)

---

[훅 — 1~2 문장]

[훅에서 본문으로 다리]

[본문 단락 1]
[근거 + 사례·인용]

[본문 단락 2]
[근거 + 사례·인용]

[본문 단락 3 (선택)]
[근거 + 사례·인용]

[클라이맥스]

[정리 — 한 줄 요약 + 실천 제안]

[다음 꼭지·장 연결]

---

## 인용·각주 (꼭지 끝)
1. [인용 1 — 발언자·매체·날짜]
2. [인용 2]
...

## 도표·자료
- [도표 X-Y. 도표 제목] — [설명]
- [그림 X-Y. 그림 제목] — [설명]

## 메타 정보
- 분량: ___자 (200자 원고지 ___매)
- 인용 출처 수: ___ 개
- 도표·자료 수: ___ 개
- 문체 일관성: ✅/❌ (장르 프리셋 준수)

6. Usage examples

Example 1 — Practical book (side-hustle book section)

book-outline-designer 출력: 2장 3꼭지 "30일 챌린지 시작하기" 시놉시스.
이 꼭지 본문 작성. 4매 (800자).

→ Hook: "One day, after five years of working as a salaried employee, I looked at my bank account balance and made up my mind." (scenario type)
→ Body: 30-day challenge in 3 steps (Step 1 self-diagnosis, Step 2 channel selection, Step 3 first sales) + examples
→ Climax: "After 30 days, side-hustle sales appeared in my bank account for the first time."
→ Summary: "The key to the 30-day challenge is not starting, but not stopping."
→ Next connection: "In the next section, we cover how to select a channel to make your first 1 million won in sales."
→ Placeholders for 2 diagrams/checklists

Example 2 — IT introductory book (Next.js section)

"Next.js 15 App Router 첫 페이지 만들기" 꼭지 본문 작성. 8매 (1,600자).
주니어 3년차 개발자 페르소나.

→ Hook: "For those of us used to the Pages Router, the App Router is a new paradigm." (problem definition)
→ Body: 1) App Router folder structure / 2) Writing the first page.tsx / 3) Verifying it works
→ 3 code blocks (folder tree, page.tsx, execution result)
→ Climax: "The core of the App Router is that server components are the default."
→ Summary: "✅ Create the App Router folder ✅ Write page.tsx ✅ Verify it works"
→ Next connection: "In the next section, we cover common layouts with layout.tsx."

Example 3 — Essay (working mom section)

"새벽 5시, 카페에서 만난 나" 에세이 1장 본문 작성. 5매 (1,000자).
40대 워킹맘 시점.

→ Hook: "5 a.m. The fluorescent lights of the neighborhood 24-hour cafe are coldly blue." (scene description)
→ Body: The daily routine of going out to write at dawn + encountering oneself in that place + reflections on the term "mother"
→ Humanities preset → narrative, metaphor, stylistic consistency

7. Korean publishing body text conventions

200-character manuscript paper conversion guide

Length expressions Conversion
1 매 200 characters (including spaces)
1 page (Word) About 400 characters (excluding spaces)
1 A4 page (10pt, 1.5 line spacing) 약 3-4 매
200쪽 책 약 200-250 매
300쪽 책 약 300-400 매

Notes on Korean style

  1. Mixing '~da'/'~mnida' prohibited — Consistency within a single work
  2. Sino-Korean words → native Korean — Prefer native Korean expressions where possible (e.g., "발휘" → "드러난다" instead of "발휘된다")
  3. Quotation marks — Korean standard quotation marks "" ' '
  4. Foreign word notation — National Institute of Korean Language foreign word notation rules (e.g., "컨텐츠" instead of "콘텐츠" is incorrect)
  5. Number notation — Numbers in body text in Hangul (five), in charts/statistics in Arabic numerals (5)

Publisher-specific body text formats

Publisher Preferred endings Style
Hanbit Media ~다 Clear and precise
Insight ~다 Precise and professional
Gilbut ~hamnida Friendly and encouraging
Woongjin Jisik House ~hamnida Friendly and promising
Dasang Books ~hamnida Friendly and encouraging
Minumsa Author's freedom Literary
Munhakdongne Author's freedom Literary
Changbi Author's freedom Social and literary

8. Precautions

Avoiding body text pitfalls

Pitfall How to avoid
Length overflow If a section exceeds ±20% of its allotted length, consider splitting into the next section
Genre style violation Consistency with the four genre presets (no fiction style in practical books)
Missing citation notation Cite sources for all quotations, statistics, and statements
Overuse of abstract words Abstract words like "various", "several", "many" → specific numbers
AI 티 (Slop) After drafting the body text, moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize chaining is required
Excessive Sino-Korean words Prefer native Korean, use Sino-Korean only for precise terminology
Ignoring publisher format Check the target publisher's ending and style conventions in advance

Citation and copyright precautions

  • Direct quotation: Short quotations use quotation marks + source, long quotations use a separate paragraph + source
  • Fair use limits: Recognition of fair use for criticism, research, and educational purposes under Korean copyright law; however, quoting the entirety of a core section is prohibited
  • External reference materials: Direct quotation prohibited
  • Images and charts: Self-produced or with clear licensing (CC BY, CC0, etc.)
  • Interview statements: Consent of the speaker + specify media and date

Length management

  • Maintain within ±20% of the target length: If over or under, split or merge
  • Unify the average length of sections: So that sections within a chapter are not too uneven
  • Climax length limit: Within 10% of the main text (too long is distracting)

Source policy

  • All quotations, statistics, and cases must have their sources specified
  • Direct quotation of external reference materials outside the vault is prohibited
  • After writing the main text, quotation and footnote summary table is recommended to be output separately

9. Related skills

Before (previous stage — all must be completed)

  • book-concept-planner — Concept document and USP
  • book-target-reader — Persona (determines the main text's style and tone)
  • book-outline-designer — Chapter synopsis (5 elements)
  • book-author-bio — Author identity (first person and perspective of the main text)

After (chaining)

  • book-revision-coach — Revision and proofreading (immediately after writing the first draft of the main text)

Alternative

  • moai-marketer:content-blog — Blog posting (short-form content)
  • moai-marketer:content-newsletter — Newsletter (series content)

Post (review — recommended chain)

  • book-revision-coach — Revision and proofreading
  • moai-writer:korean-spell-check — Korean spelling
  • moai-coworker:ai-slop-reviewer — AI slop review (required)
  • moai-writer:korean-humanize — Precise polishing to remove AI traces (required)

⚠️ Published main text is the output where AI traces are most evident. The regular chain book-chapter-writer → moai-coworker:ai-slop-reviewer → moai-writer:korean-humanize is required.

10. Sources

External official sources (as of 2026)

Material URL Purpose
KPIPA https://www.kpipa.or.kr Publishing standards and manuscript length guide
National Institute of Korean Language https://www.korean.go.kr Korean spelling and foreign word notation
Korea Publishing Contents KPC https://www.kpc.or.kr Publishing editing guide
Korea Copyright Commission https://www.copyright.or.kr Copyright and fair use guide

Vault reference (concepts and frameworks only)

Extract insights related to "main text writing, style, concreteness, and quotation" from the GOOS Obsidian vault (applying the 7 copywriting techniques + 6 sentence collection methods + 3-step insight derivation). Do not use original metaphors or expressions as-is.


Version history

  • v2.9.0 (2026-05-17): New skill introduced. moai-coworker plugin workflow 7. Section 5 elements (hook, body, climax, wrap-up, connection) + 4 genre style presets + 200-character manuscript paper count + quotation, footnote, and chart handling + publisher-specific main text conventions.