스프쌤
스레드

polish-doc — 문서 다듬기 스킬

✍ @albert.rim⏱ 3분 소요2026-10-29👁
← 목록으로 돌아가기

안녕하세요. 야금야금입니다.

"문서는 쓰는데 읽는 사람이 없다" — 읽히는 문서로 다듬는 스킬 polish-doc을 정리합니다.

📌 한눈에 보는 요약
✔️ polish-doc — 내부 문서 다듬기 스킬
✔️ standalone HTML · 12살도 이해하는 수준
✔️ 다이어그램 + 단답형 + 중복 삭제 + 퇴고
STEP 0

읽히는 문서의 조건

쓰기보다 다듬기

1지침의 포인트

이해도를 기준으로


핵심은 "12살 아이도 이해할 수 있는 수준" — 전문 용어를 풀고, 다이어그램을 적극 활용하며, 문장은 단답형으로 간결하게. 그리고 중복·장황·히스토리 같은 군더더기를 삭제합니다. "독자가 읽는 시간"을 기준으로 다듬는 원칙입니다.

STEP 1

마지막 퇴고

사람이 쓴 것처럼

2AI 티 지우기

자연스러운 문장으로


다 작성한 뒤엔 "사람이 쓴 듯한 퇴고"를 한 번 더 돌립니다 — AI 특유의 나열·뻔한 접속사·정형 문장을 사람 말투로 바꿉니다. 결과는 단일 standalone HTML이라 공유도 간편합니다.

원문장황·중복→구조 다듬기다이어그램·단답→사람 퇴고자연 문장
💡 개인에게 주는 시사점 문서의 품질은 "독자가 이해하는 속도"입니다 — 12살 기준이라는 목표 하나가 글쓰기의 나쁜 습관을 잡아줍니다.

자주 묻는 질문

Q. 뭔가요?
A. 내부 문서를 다듬는 스킬입니다.

Q. 원칙이 뭔가요?
A. 쉽게·간결하게·다이어그램으로입니다.

Q. 어디서 받나요?
A. GitHub에 공개된 스킬입니다.

마무리

오늘은 문서 다듬기 스킬 polish-doc을 정리했습니다.

읽히지 않는 문서가 있다면 원칙부터 적용해보세요.

📌 함께 보면 좋은 칼럼
✔️ 디자인 시스템 300선
✔️ 프레이머 페이지
✔️ 옵시디언 Agent LLMs

원본

https://www.threads.com/@albert.rim/post/Dc2xeXdoL7n

https://github.com/albertrim/polish-doc

함께 보면 좋은 글

댓글 0개