yd-writer-kr SKILL.md skillA

yd-writer-kr from leeyudok/doksam-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add leeyudok/doksam-skills/yd-writer-kr@git:20261004.346872c

Pins git:20261004.346872c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
leeyudok/doksam-skills
Path
skills/yd-writer-kr/SKILL.md
Versions recorded
3
Latest version
git:20261004.346872c, committed Oct 4, 2026
First version recorded
Oct 4, 2026
Size
10,942 bytes
Repository stars
14
License
MIT

doksam 스타일 한국어 글쓰기·교정 — 의미가 전달되는 논리적 단문, 번역투·군더더기 제거, 주장마다 근거. 이슈·MR/PR 본문, 문서(docs·README·wiki), 공지(디스코드·메일), 보고서·칼럼·기획서를 한국어로 쓰거나 고칠 때 사용한다. "글 다듬어", "읽기 쉽게", "번역투 빼고", "논리적으로", "유시민처럼" 같은 요청이나, 규칙을 말하지 않아도 사람이 읽을 한국어 산문을 쓸 때 적용한다. 채팅 대화체(MZ체)에는 문장 원칙만 쓰고 종결 규칙은 쓰지 않는다.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# yd-writer-kr — 의미가 전달되는 한국어

기준은 길이가 아니라 **의미 전달**이다(『유시민의 글쓰기 특강』).
짧게 자르는 것이 목표가 아니다. 읽는 사람이 무엇을 알고 무엇을 할지 분명해야 한다.

## 0. 어디에 쓰나 — 문체 두 갈래

| 대상 | 문체 | 이 스킬 적용 범위 |
|---|---|---|
| 이슈·MR 본문, 커밋 본문, docs·wiki, 보고서 | 표준 문어체(~한다/~이다) | 전부 |
| README·사용 안내·공지처럼 사용자에게 말하는 글 | ~합니다 체도 쓸 수 있다 | 전부 (~함·~임 종결 금지는 같다) |
| 채팅 응답(사용자와의 대화) | MZ체(~요, ~함, ㅇㅇ, ㅇㅋ) | 원칙 1·3·5만. 종결 규칙(~함 금지)은 적용하지 않는다 |
| 코드·명령어·식별자·표 안의 값·인용문·고유명사 | 원문 그대로 | 건드리지 않는다 |

한 문서 안에서는 문체를 섞지 않는다. 기존 문서를 고칠 때는 그 문서의 문체를 따른다. 새 README 는 저장소의 다른 README 문체를 따른다.

채팅에서 산출물로, 산출물에서 채팅으로 넘어갈 때 문체가 따라오지 않게 한다.
긴 세션에서 이슈 본문을 쓴 직후 채팅까지 격식체가 되는 것이 가장 흔한 실수다.

## 원칙 1. 먼저 독자와 요점을 정한다

- 쓰기 전에 두 가지를 한 문장씩 정한다. 독자가 알아야 할 것, 독자가 해야 할 것.
- 그 한두 가지가 첫 단락에 드러나게 쓴다. 결론을 뒤에 숨기지 않는다.
- 상태 질문의 답은 yes/no 와 짧은 근거로 시작한다.

## 원칙 2. 단문 — 한 문장에 생각 하나

- 한 문장에는 생각 하나만 담는다. 40자 안팎을 눈금으로 삼되, 의미를 자르면서까지 맞추지 않는다.
- 주어와 서술어는 한 번만 쓰고 서로 호응하게 한다.
- 접속사로 길게 잇지 않는다. 마침표를 찍고 새로 시작한다.

## 원칙 3. 필요 없는 것은 뺀다

- 독자에게 필요 없는 배경, 괄호 부연, 내부 사정은 뺀다. 필요한 근거는 남긴다.
- 독자별로 다르다. 이슈·MR 에서는 이슈 번호·파일 경로·커밋이 근거다. 사람에게 보내는 공지에서는 내부 사정이다.
- 없어도 뜻이 통하는 낱말은 지운다. 부사·형용사는 꼭 필요할 때만 쓴다.
- 금지 표현은 `references/banned-expressions.md` 와 대조한다(번역투·일본어투·이중 피동·중복 수식).

## 원칙 4. 주장에는 근거
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add leeyudok/doksam-skills/yd-writer-kr@sha256:35670b546ec5afcb

The line at the top of this page pins the label git:20261004.346872c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mjllmaqruyccdiaw.svg)](https://markdownregistry.com/a/art_mjllmaqruyccdiaw)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, all committed on Oct 4, 2026.

versioncommittedcommitsizeaudit
git:20261004.346872c latest2026-10-04 346872c 10,942 BA view · diff
git:20261004.ae80c732026-10-04 ae80c73 9,305 BA view · diff
git:20261004.ffb83142026-10-04 ffb8314 7,341 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10942 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

leeyudok/doksam-skills · 14 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mjllmaqruyccdiaw
GET https://markdownregistry.com/api/v1/resolve?ref=leeyudok/doksam-skills/yd-writer-kr
GET https://markdownregistry.com/api/v1/blob/35670b546ec5afcbfe1e99cf48b9b637338902eb4df4c398ff8ee7618dec7323

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from leeyudok/doksam-skills

AGENTS.md AGENTS.md file
leeyudok/doksam-skills · AGENTS.md
git:20261017.ec49e19 · audit A · 14 stars
yd-agents-mem SKILL.md skill
leeyudok/doksam-skills · skills/yd-agents-mem/SKILL.md · 에이전트 메모리·전역 지침·설정을 GitLab agents-mem 레포에 백업하고 되돌린다. 전역 CLAUDE.md·infra-*.md·ref-*.md·프로젝트 메모리·스킬·에이전트·settings 를 고친 뒤…
git:20261011.76a7b1a · audit A · 14 stars
yd-agents-yaml SKILL.md skill
leeyudok/doksam-skills · skills/yd-agents-yaml/SKILL.md · 저장소의 에이전트 지침을 사람용 AGENTS.md + 기계 판독용 AGENTS.yaml + 검증기 scripts/check-agents-yaml.sh 세 파일로 세팅하거나 갱신한다. AGENTS.yaml 이 없는…
git:20261011.76a7b1a · audit A · 14 stars
yd-blueprint SKILL.md skill
leeyudok/doksam-skills · skills/yd-blueprint/SKILL.md · 프로젝트의 구조·기록 흐름·구현 현황·남은 작업을 JSONL 데이터로 적고 bun+Vite+React 청사진 화면(localhost:5173/blueprint/)으로 띄운다. 청사진·구조도·구현 현황표를 만들거나…
git:20261011.fc9c4fb · audit A · 14 stars
yd-claude-auth-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-claude-auth-sync/SKILL.md · 한 PC 에서 claude login 으로 다시 인증한 Claude Code 로그인을, 사용자가 등록해 둔 다른 PC·서버에도 똑같이 맞춘다. 키체인·~/.claude/.credentials.json 의…
git:20261017.ec49e19 · audit B · 14 stars
yd-db-expert SKILL.md skill
leeyudok/doksam-skills · skills/yd-db-expert/SKILL.md · 엔진과 무관한 관계형 설계를 다룰 때 사용한다 — 스키마 정규화·키·NULL 의미·DB 제약·소프트 삭제·인덱스 선택 원칙·쿼리 규칙(N+1·플레이스홀더·커서 페이징)·트랜잭션 경계·마이그레이션 단계…
git:20261011.76a7b1a · audit A · 14 stars
yd-doc-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-doc-sync/SKILL.md · 문서 현행화(doc-sync) — 코드·구성이 바뀐 뒤(디렉터리 삭제·이동, 포트·명령·의존성 변경, 큰 리팩터링 머지) 에이전트 지침(AGENTS.md·CLAUDE.md)·README·규칙(.claude/rules…
git:20261011.980cdb2 · audit A · 14 stars
yd-doksam-ui SKILL.md skill
leeyudok/doksam-skills · skills/yd-doksam-ui/SKILL.md · doksam 프로젝트의 UI 를 만들거나 수정할 때, 사용자가 "ui.doksam.com 참고" / "doksam-ui" / "독삼 표준 UI" 라고 말할 때, 프론트엔드 작업이 doksam 인프라를 대상으로 할…
git:20261004.0d5ff50 · audit B · 14 stars
yd-finguard SKILL.md skill
leeyudok/doksam-skills · skills/yd-finguard/SKILL.md · FinGuard CLI로 소스코드 취약점을 점검하고 심각도 기반 보안 게이트와 제한된 수정·재검증 루프를 수행할 때 사용한다. 일반 코드 품질 리뷰나 SCA·모의해킹은 범위 밖이다.
git:20261004.0d5ff50 · audit A · 14 stars
yd-frontend-build SKILL.md skill
leeyudok/doksam-skills · skills/yd-frontend-build/SKILL.md · pnpm 워크스페이스와 Vite 빌드를 설정·정비하거나, 의존성·락파일·번들 크기·폐쇄망 self-host 문제를 다룰 때 사용한다. 프레임워크 자체의 코드 작성이 아니라 빌드/패키징 층이 대상이다.
git:20261004.c66a4ea · audit A · 14 stars
yd-git-ship SKILL.md skill
leeyudok/doksam-skills · skills/yd-git-ship/SKILL.md · GitLab 레포에 에이전트(Claude Code·Codex·Antigravity)가 작업을 올리는 절차 — 이슈 등록, batch/<agent>-<날짜>-<8자리 hex> 브랜치, "[<model>]…
git:20261011.76a7b1a · audit A · 14 stars
yd-git-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-git-sync/SKILL.md · 여러 호스트(맥·pig·doksam 등)에 클론해 둔 같은 저장소를 맞춘다 — 각 클론을 git pull --ff-only 로 origin 에 맞추고 추적 파일 수·목록 해시를 비교한 뒤, git 이 관리하지 않는…
git:20261015.6d4494b · audit A · 14 stars

Every file in leeyudok/doksam-skills

Other files named yd-writer-kr

yd-writer-kr SKILL.md skill
leeyudok/agents-scaffold · .claude/skills/yd-writer-kr/SKILL.md · doksam 스타일 한국어 글쓰기·교정 — 의미가 전달되는 논리적 단문, 번역투·군더더기 제거, 주장마다 근거. 이슈·MR/PR 본문, 문서(docs·README·wiki), 공지(디스코드·메일)…
git:20261024.c5b81d9 · audit A · 38 stars
yd-writer-kr SKILL.md skill
leeyudok/agents-scaffold · plugins/yd-skills/skills/yd-writer-kr/SKILL.md · doksam 스타일 한국어 글쓰기·교정 — 의미가 전달되는 논리적 단문, 번역투·군더더기 제거, 주장마다 근거. 이슈·MR/PR 본문, 문서(docs·README·wiki), 공지(디스코드·메일)…
git:20261024.27d9360 · audit A · 38 stars

Browse by kind, by grade A, or by owner.