| name | write-korean-blog |
| description | 독자의 질문에 답하는 자연스러운 한국어 블로그와 설명문을 작성하는 스킬. 정보성 블로그, 개념 설명, 입문 가이드, 사용법, 비교 글, 제품·서비스 설명, 사례 소개와 FAQ형 콘텐츠를 주제나 자료에서 새로 작성하거나 기존 초안을 재구성할 때 사용한다. "초보자도 이해하는 글로 써 줘", "블로그 게시물로 만들어 줘", "검색 키워드는 살리되 자연스럽게 써 줘", "AI 티 없는 설명문을 작성해 줘" 같은 요청에도 사용한다. 독자의 검색 의도, 핵심 답, 근거와 출처, 제목의 약속, 읽기 흐름을 설계하고 과장·상투 표현·번역투를 줄인다. |
Write Korean Blog
블로그와 설명문을 독자 질문 정의 → 핵심 답 → 근거 정리 → 구조 → 초안 → 문체·구조 검사 순서로 작성하라.
1. 독자 질문과 글의 약속 정하기
- 누가 어떤 상황에서 읽는가?
- 독자가 가장 먼저 알고 싶은 답은 무엇인가?
- 읽은 뒤 무엇을 이해하거나 실행해야 하는가?
- 정보 설명, 실용 가이드, 비교, 사례 중 어떤 형식인가?
- 사용할 수 있는 경험, 사실, 수치와 출처는 무엇인가?
검색 키워드는 사용자가 요청했을 때만 자연스럽게 반영하라. 키워드 반복을 위해 제목과 문장을 훼손하지 마라.
2. 사실과 경험 구분하기
- 경험하지 않은 일을 1인칭 후기처럼 쓰지 마라.
- 확인하지 않은 통계, 인용, 가격, 기능과 최신 정보를 만들지 마라.
- 외부 근거가 필요한 주장은 조사하고 주장 가까이에 출처를 둬라.
- 비교 글은 같은 기준으로 대상을 비교하고 제휴·이해관계가 있으면 밝힐 자리를 마련하라.
- 추론과 의견은 사실처럼 단정하지 마라.
글 유형은 references/formats.md에서 선택하라.
3. 답을 숨기지 않고 작성하기
첫 두 문단 안에 핵심 답이나 문제의식을 제시하라. 오늘날, 빠르게 변화하는 시대처럼 어느 글에나 붙는 도입을 쓰지 마라.
- 제목은 본문이 실제로 지킬 약속을 담는다.
- 소제목은 독자의 다음 질문이나 절의 결론을 담는다.
- 추상적인 평가보다 장면, 행동, 사례와 수치를 사용한다.
- 모든 절을 같은 문단 수와 같은 형식으로 맞추지 않는다.
- 결론은 요약보다 독자의 판단 기준이나 다음 행동으로 끝낸다.
references/quality-gate.md를 적용하고 파일이 필요하면 assets/blog-template.md를 필요한 만큼만 사용하라.
4. 문체와 구조 검사하기
CORE_SKILL_DIR은 같은 상위 폴더의 natural-korean, WRITER_SKILL_DIR은 write-natural-korean으로 해석하라.
uv run "$CORE_SKILL_DIR/scripts/lint.py" path/to/article.md --genre blog
uv run "$CORE_SKILL_DIR/scripts/outline.py" path/to/article.md
uv run "$WRITER_SKILL_DIR/scripts/article_check.py" path/to/article.md
사용 가능한 검사 스킬만 실행하라. 검사기가 없으면 quality gate로 수동 검토하고 그 사실을 밝혀라. 일관된 존댓말과 행동 권고의 -하세요 혼용을 자동 오류로 보지 마라.
5. 최종 전달하기
독자가 읽을 완성본을 먼저 제시하라. 출처, 미확인 정보 또는 편집자가 결정할 제목 후보가 있으면 뒤에 짧게 구분하라. 내부 brief와 lint 결과는 요청받지 않으면 남기지 마라.
