跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

Korean Report Skills

A skill set that enforces consistent Korean document design and language conventions for AI agents like Claude Code, Codex, and Cursor.

JangHyun-bin · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add JangHyun-bin/korean-report-skills

技能说明

korean-report-skills

왜 Claude가 만든 한국어 문서는 어딘가 이상할까

내용은 맞는데 문서로 전달하기가 망설여지는 경험. 그 이유를 다섯 가지로 나누고 각각을 규약으로 구성한 스킬셋입니다.

Claude Code · Codex · Cursor 에 적용 가능합니다. → 설치

paper(세로·보고서) · deck(가로·협의자료) — HTML 파일 하나로 구성됩니다.


"디자인이 별로예요"

마크다운을 워드에 붙이면 볼품없고, HTML로 제작 할 경우 매번 일관되지 않은 디자인과 구성으로 표현합니다. 제목 크기도, 표 모양도, 여백도 그때그때 달라집니다.

→ 디자인 시스템을 고정했습니다. 액센트 색 하나, 그림자 없음, 표에 세로 괘선 없음. paper(세로·보고서)와 deck(가로·협의자료) 두 모드뿐이고 섞을 수 없습니다. 같은 요청에 같은 결과가 나옵니다.

"문장이 번역체 같아요"

됐다와 하였습니다가 한 문서에 섞이고, ~하는 것·~에 걸려 있다 같은 번역투가 남습니다. 읽는 사람에게 초안처럼 보입니다.

→ 치환 목록 115건과 어미 규약. 평서체와 합니다체를 섞지 않고, 필요하면 문서와 커버레터를 분리합니다.

그냥 쓰면규약 적용
반토막 넘게 늘었습니다4.2시간에서 9.1시간으로 증가하였다
모든 사슬이 승인 하나에 걸려 있다승인 이후 착수할 수 있다
각 절은 근거를 함께 갖는다각 절에 근거를 명시하였다

지켜졌는지 확인할 수 있습니다. 규약이 표로만 있으면 지켜졌는지 아무도 모릅니다. 같이 실려 가는 검사기가 문서를 훑어 걸린 곳을 줄·열로 알려줍니다.

$ python korean-report-style/assets/lint.py 보고서.md
보고서.md:5:24  [검토] 반토막이 된다 → 절반 수준으로 낮아진다    (§3 구어체 환언)
보고서.md:5:38  [고침] 했다 → 하였다                          (§1 어미)
보고서.md:10:1  [제목] 무엇이 달라지나 → 명사구로 고친다        (§1.1 제목은 명사구)

--fix 는 어미만 자동으로 고칩니다. `넘긴다 → 전