Korean Report Skills

korean-report-skills

[](../../actions) [](../../releases) [](INSTALL.md) [](LICENSE)

Claude가 쓴 글이 어딘가 이상할 때

내용은 올바르더라도 번역체, 모호한 수치, 들쭉날쭉한 페이지 배치가 남으면 문서는 아직 초안처럼 보입니다.

`korean-report-style`은 문체와 근거를 다듬고, `korean-report-doc`은 그 내용을 일관된 `layout`으로 구성합니다. 이어서 HTML `typesetting`과 렌더 검사를 수행하고, 필요하면 PDF와 검수용 스크린샷까지 생성합니다.

여기서 `layout`은 페이지와 요소의 배치를, `typesetting`은 CSS·글꼴·수식을 반영해 최종 HTML을 만드는 처리 단계를 뜻합니다.

글만 다듬을 때는 `korean-report-style`을 사용합니다. HTML이나 PDF까지 필요할 때는 `korean-report-doc`을 함께 사용합니다. Claude Code, Codex, Cursor, OpenCode에서 사용할 수 있습니다.

두 스킬의 역할

스킬	맡는 일	결과
korean-report-style	문체, 프레이밍, 용어, 상태·근거 표기, 편집 후 정합성 검토	수정 원고와 lint 결과
korean-report-doc	문서 구조, paper·deck 모드의 layout, 도해, 수식, HTML typesetting, 렌더 QA	자립형 HTML과 선택적 PDF

문체 스킬은 어미만 바꾸는 교정기가 아닙니다. 실측과 추정을 구분하고, 주장에 근거가 있는지 확인하며, 리스크와 대응이 함께 적혀 있는지도 살핍니다. 문서 스킬을 함께 쓰면 이 검토를 공통 디자인 시스템과 브라우저 렌더 검사까지 이어 갑니다.

사용 예

설치한 뒤에는 평소처럼 작업을 요청하면 됩니다.

지난주 벤치 결과로 기술보고서를 작성해 줘.
이 문단을 외부 협력사에 전달할 보고 문체로 수정해 줘.
이 진행현황에서 미측정 수치와 근거가 없는 주장을 표시해 줘.
회의에서 검토할 쟁점과 결정 요청을 가로형 협의자료로 만들어 줘.

스킬 이름을 직접 적을 필요는 없습니다. 명시적으로 선택하려면 Codex에서는 `$korean-report-doc`, Claude Code에서는 `/korean-report-doc`처럼 요청할 수 있습니다.

설명이나 요약만 요청하면 대화 안에서 답하고, 별도의 문서 파일은 만들지 않습니다. HTML이나 PDF처럼 완성된 산출물을 요청하면 문서 제작 절차를 시작합니다.

결과물

문서의 목적에 따라 `paper`와 `deck` 중 하나를 선택합니다.

항목	paper	deck
잘