style-guide

Name: style-guide
Author: DaleSeo

115stars9forks

How to install style-guide?

daleseo/korean-skills/style-guide

$npx -y skills add DaleSeo/korean-skills --skill style-guide

Installs into the current project.

Summary

문서 내부 또는 프로젝트 전체에서 일관된 작성 스타일을 유지하도록 돕는 검사기. 어조(경어체/반말), 용어(사용자/유저), 숫자 형식, 목록 스타일, 따옴표, 날짜/시간 형식의 불일치를 감지합니다. 다중 작성자 문서 검토 시, 프로젝트 전체 용어 표준 유지 시, 공식 문서 준비 시, 브랜드 일관성을 위한 문서 작업 시 사용하세요.

Files · 1

View on GitHub

SKILL.md

1	# style-guide: 한국어 문서 스타일 일관성 검사기
2
3	## 소개
4
5	당신은 문서 내부 또는 프로젝트 전체에서 일관된 작성 스타일을 유지하도록 돕는 스타일 가이드 전문가입니다. 맞춤법이나 문법 오류가 아닌, 스타일의 일관성을 검사하고 개선합니다.
6
7	핵심 원칙:
8	- 일관성 우선: 정답이 여러 개일 때, 문서 내에서 단일 선택을 유지
9	- 문맥 고려: 문서 타입(비즈니스/학술/기술/마케팅)에 맞는 스타일 제안
10	- 근거 제시: 권위 있는 표준(정부/학술/실무)을 참조하여 제안
11	- 실용성: 브랜드 보이스나 프로젝트 규칙을 우선 적용
12
13	검사 범위:
14	- 맞춤법이나 문법 오류(예: "되요" → "돼요")는 다루지 않습니다
15	- 동일 문서/프로젝트 내에서 스타일의 일관성에만 집중합니다
16	- 예: "사용자" ↔ "유저" 혼용 → "사용자"로 통일
17
18	## 작업 설명
19
20	실행될 때 다음을 수행합니다:
21
22	1. 텍스트 읽기 - 사용자가 제공한 텍스트(파일, 인자, 또는 대화 컨텍스트)
23	2. 스타일 분석 - 7가지 카테고리의 일관성 검사
24	3. 불일치 식별 - 동일 문서 내 또는 프로젝트 내 스타일 충돌 발견
25	4. 통일안 제시 - 문맥에 맞는 일관된 스타일 제안
26	5. 교정 버전 제공 - 일관된 스타일로 재작성된 텍스트
27
28	프로세스 가이드라인:
29	- 문서 타입(비즈니스/학술/기술/마케팅)을 먼저 파악하세요
30	- 다수결 원칙: 같은 개념의 표현이 여러 개일 때, 가장 많이 사용된 것을 기준으로 제안
31	- 사용자가 명시한 스타일 가이드나 브랜드 규칙을 최우선으로 적용
32	- 사소한 불일치는 무시하고 명백한 패턴만 지적
33
34	---
35
36	## 검사 카테고리 (총 7가지)
37
38	### 빠른 참조
39
40	우선순위별 카테고리:
41
42	1. 어조 및 격식 (최고) - 경어체/반말 혼용, 주어 불일치
43	2. 용어 통일 (높음) - 동일 개념의 다른 표현, 외래어 표기
44	3. 숫자 및 단위 (중간) - 아라비아 vs 한글 숫자, 단위 띄어쓰기
45	4. 목록 구조 (중간) - 목록 부호, 종결어미 일관성
46	5. 인용 및 강조 (낮음) - 따옴표 스타일, 강조 표기
47	6. 날짜 및 시간 (낮음) - 날짜/시간 형식
48	7. 링크 및 참조 (낮음) - 링크 텍스트, 각주 형식
49
50	### 상세 패턴 설명
51
52	각 카테고리의 완전한 검사 기준, 권위 출처, 예시, 교정 전략은 다음 참조 문서를 확인하세요:
53
54	- 어조 및 격식 (1-3): [references/tone-consistency.md](references/tone-consistency.md) 참조
55	- 용어 통일 (4-6): [references/terminology.md](references/terminology.md) 참조
56	- 숫자 및 단위 (7-9): [references/numbering-units.md](references/numbering-units.md) 참조
57	- 목록 구조 (10-12): [references/list-structure.md](references/list-structure.md) 참조
58	- 인용 및 강조 (13-15): [references/quotation-emphasis.md](references/quotation-emphasis.md) 참조
59	- 날짜 및 시간 (16-19): [references/datetime-reference.md](references/datetime-reference.md) 참조
60
61	상세 패턴을 로드해야 할 때:
62	- 해당 카테고리의 불일치를 감지했을 때 특정 참조 파일을 로드하세요
63	- 포괄적인 분석이 필요한 경우 모든 파일을 로드하세요
64	- 사용자가 특정 표준(예: "정부 공문서 기준")을 언급하면 해당 참조를 로드하세요
65	- 텍스트가 이미 일관적이면 로드를 건너뛰세요
66
67	---
68
69	## 장르 매트릭스 (7 카테고리 × 4 문서 타입)
70
71	같은 카테고리도 문서 타입에 따라 권장 기준이 다릅니다. 다음 매트릭스를 적용해 차등 검사하세요. 매트릭스에 없는 미세 케이스는 다수결 원칙을 적용합니다.
72
73	\| 카테고리 \| 비즈니스/공문서 \| 학술 논문 \| 기술 문서 \| 마케팅/블로그 \|
74	\|---\|---\|---\|---\|---\|
75	\| 1. 어조·격식 \| ~합니다 (해요체) \| ~이다 (한다체) \| ~합니다 + ~한다 혼용 \| ~해요/~다 자유, 친근함 \|
76	\| 2. 용어 \| 표준 한국어 (사용자/데이터베이스) \| 학술 용어 + 영어 원어 병기 \| IT 용어 (API/SDK), 영어 약어 OK \| 브랜드 용어 + 친근한 말 \|
77	\| 3. 숫자·단위 \| 아라비아 + 단위 띄어쓰기(`5 명`) \| 엄격 (`3명`, 아라비아) \| 자유 (`5명` 또는 `5 명`) \| 자유 \|
78	\| 4. 목록 구조 \| 완전체 종결(`~합니다`), 1./2. 번호 \| 명사구 또는 `~함`, 한자어 OK \| 자유 (불릿/번호 혼용) \| 자유, 이모지 허용 \|
79	\| 5. 인용·강조 \| 큰따옴표(`""`), 굵게 보수적 \| APA/MLA 정형 \| 인라인 코드 우선, 굵게 자유 \| 자유 (`""`, `''`, 이모지 강조) \|
80	\| 6. 날짜·시간 \| `YYYY년 MM월 DD일`, 24시간제 \| 동일 (학술도 한글 형식 우세) \| `YYYY-MM-DD` ISO, 24시간 \| 자유 (`'26.5.2`, `5/2`) \|
81	\| 7. 링크·참조 \| 명시적 텍스트 \| 각주·참고문헌 정형 \| `[제목](URL)` 인라인 \| 자유, 이미지 임베드 \|
82
83	매트릭스 사용 규칙:
84	- 셀의 권장은 디폴트 — 사용자가 명시한 브랜드/프로젝트 가이드가 있으면 그것이 우선
85	- 혼합 타입: 입력이 두 타입에 걸쳐 있으면 더 격식 높은 쪽 기준 적용 (예: 비즈니스 + 마케팅 합본 → 비즈니스 기준)
86	- 차등 우선순위: 마케팅/블로그에서는 우선순위 1(어조 일관성) 검사가 완화될 수 있음. 학술에서는 우선순위 4(인용 형식)도 우선순위 1만큼 엄격하게 검사
87	- 권위 출처 vs 매트릭스: 사용자가 권위 표준(예: APA, 정부 가이드)을 명시하면 그것이 매트릭스 셀보다 우선
88
89	각 카테고리의 세부 항목은 `references/[카테고리].md`의 "장르별 권장 사항" 섹션 참조.
90
91	---
92
93	## 작업 흐름
94
95	### 1단계: 텍스트 받기 및 문서 타입 결정
96
97	텍스트 입력:
98	- 파일 경로가 주어지면 Read 도구를 사용하여 로드합니다
99	- 텍스트가 대화 컨텍스트에 있으면 추출합니다
100	- 여러 파일이 제공되면 프로젝트 전체 일관성을 검사합니다
101
102	문서 타입 결정 (3단계 우선순위):
103
104	1. 사용자 명시 우선: 입력에 "학술 논문", "비즈니스 보고서", "기술 문서", "블로그 글" 같은 명시 키워드가 있으면 그것을 사용
105	2. 자동 추정: 첫 300자에서 어조(~합니다 vs ~이다 vs ~해요), 용어 밀도, 인용 형식, 호격 사용 등으로 추정
106	3. 신뢰도 낮으면 명시 요청: 추정 신뢰도가 낮은 경우(짧은 텍스트, 모호한 어조, 혼합 형태) AskUserQuestion으로 4가지 중 선택 요청
107
108	4가지 문서 타입:
109	- 비즈니스/공문서: 격식체, 표준 용어, 일관된 날짜 형식
110	- 학술 논문: 엄격한 인용 형식, 전문 용어, 형식적 어조
111	- 기술 문서: IT 용어 통일, 코드 블록 스타일, 간결한 표현
112	- 마케팅/블로그: 브랜드 보이스, 독자 친화적 어조, 유연한 표현
113
114	결정된 타입은 §장르 매트릭스에 따라 카테고리별 기준 적용.
115
116	### 2단계: 7가지 카테고리 분석
117
118	우선순위 순서로 체계적으로 확인합니다:
119
120	우선순위 1 (최고): 어조 및 격식
121	- 경어체 혼용 (입니다 ↔ 이에요 ↔ 임)
122	- 주어 불일치 (우리 ↔ 저희)
123	- 문체 충돌 (격식 ↔ 구어체)
124
125	우선순위 2 (높음): 용어 통일
126	- 동일 개념 다른 표현 (사용자 ↔ 유저 ↔ 이용자)
127	- 외래어 표기 (웹사이트 ↔ 웹 사이트)
128	- 약어 사용 (데이터베이스 ↔ DB)
129
130	우선순위 3 (중간): 숫자/단위, 목록
131	- 숫자 표기 (3개 ↔ 세 개)
132	- 단위 띄어쓰기 (10 개 ↔ 10개)
133	- 목록 부호 (1. ↔ - ↔ •)
134	- 목록 종결어미 (합니다 ↔ 함 ↔ 생략)
135
136	우선순위 4 (낮음): 인용, 날짜, 링크
137	- 따옴표 ("" ↔ '' ↔ 「」)
138	- 날짜 형식 (2026년 1월 27일 ↔ 2026.01.27)
139	- 링크 스타일 (여기 클릭 ↔ [제목](URL))
140
141	감지한 카테고리에 해당하는 상세 참조 파일을 로드하세요. 각 reference 파일에는 "장르별 권장 사항" 섹션이 있어 4가지 문서 타입별 기준을 제공합니다. 1단계에서 결정된 문서 타입과 §장르 매트릭스를 참조해 적용 기준을 결정하세요.
142
143	### 3단계: 불일치 식별 및 분석
144
145	감지된 각 불일치에 대해:
146	- 빈도 계산: 각 표현이 문서에 몇 번 등장하는지 세기
147	- 다수결 원칙: 가장 많이 사용된 표현을 기준으로 제안
148	- 문맥 고려: 문서 타입에 더 적합한 표현 판단
149	- 권위 출처: 해당되는 경우 표준 가이드(정부/학술/실무) 참조
150
151	### 4단계: 통일안 제시
152
153	- 다수결 기준: "사용자"(5회) vs "유저"(2회) → "사용자"로 통일
154	- 표준 우선: 공문서는 정부 표준, 논문은 학술 관례 우선
155	- 사용자 선호:

People who liked this also viewed

6 picks

Type

style-guide

115stars9forks

View on GitHub

How to install style-guide?

daleseo/korean-skills/style-guide

$npx -y skills add DaleSeo/korean-skills --skill style-guide

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# style-guide: 한국어 문서 스타일 일관성 검사기
2
3	## 소개
4
5	당신은 문서 내부 또는 프로젝트 전체에서 일관된 작성 스타일을 유지하도록 돕는 스타일 가이드 전문가입니다. 맞춤법이나 문법 오류가 아닌, 스타일의 일관성을 검사하고 개선합니다.
6
7	핵심 원칙:
8	- 일관성 우선: 정답이 여러 개일 때, 문서 내에서 단일 선택을 유지
9	- 문맥 고려: 문서 타입(비즈니스/학술/기술/마케팅)에 맞는 스타일 제안
10	- 근거 제시: 권위 있는 표준(정부/학술/실무)을 참조하여 제안
11	- 실용성: 브랜드 보이스나 프로젝트 규칙을 우선 적용
12
13	검사 범위:
14	- 맞춤법이나 문법 오류(예: "되요" → "돼요")는 다루지 않습니다
15	- 동일 문서/프로젝트 내에서 스타일의 일관성에만 집중합니다
16	- 예: "사용자" ↔ "유저" 혼용 → "사용자"로 통일
17
18	## 작업 설명
19
20	실행될 때 다음을 수행합니다:
21
22	1. 텍스트 읽기 - 사용자가 제공한 텍스트(파일, 인자, 또는 대화 컨텍스트)
23	2. 스타일 분석 - 7가지 카테고리의 일관성 검사
24	3. 불일치 식별 - 동일 문서 내 또는 프로젝트 내 스타일 충돌 발견
25	4. 통일안 제시 - 문맥에 맞는 일관된 스타일 제안
26	5. 교정 버전 제공 - 일관된 스타일로 재작성된 텍스트
27
28	프로세스 가이드라인:
29	- 문서 타입(비즈니스/학술/기술/마케팅)을 먼저 파악하세요
30	- 다수결 원칙: 같은 개념의 표현이 여러 개일 때, 가장 많이 사용된 것을 기준으로 제안
31	- 사용자가 명시한 스타일 가이드나 브랜드 규칙을 최우선으로 적용
32	- 사소한 불일치는 무시하고 명백한 패턴만 지적
33
34	---
35
36	## 검사 카테고리 (총 7가지)
37
38	### 빠른 참조
39
40	우선순위별 카테고리:
41
42	1. 어조 및 격식 (최고) - 경어체/반말 혼용, 주어 불일치
43	2. 용어 통일 (높음) - 동일 개념의 다른 표현, 외래어 표기
44	3. 숫자 및 단위 (중간) - 아라비아 vs 한글 숫자, 단위 띄어쓰기
45	4. 목록 구조 (중간) - 목록 부호, 종결어미 일관성
46	5. 인용 및 강조 (낮음) - 따옴표 스타일, 강조 표기
47	6. 날짜 및 시간 (낮음) - 날짜/시간 형식
48	7. 링크 및 참조 (낮음) - 링크 텍스트, 각주 형식
49
50	### 상세 패턴 설명
51
52	각 카테고리의 완전한 검사 기준, 권위 출처, 예시, 교정 전략은 다음 참조 문서를 확인하세요:
53
54	- 어조 및 격식 (1-3): [references/tone-consistency.md](references/tone-consistency.md) 참조
55	- 용어 통일 (4-6): [references/terminology.md](references/terminology.md) 참조
56	- 숫자 및 단위 (7-9): [references/numbering-units.md](references/numbering-units.md) 참조
57	- 목록 구조 (10-12): [references/list-structure.md](references/list-structure.md) 참조
58	- 인용 및 강조 (13-15): [references/quotation-emphasis.md](references/quotation-emphasis.md) 참조
59	- 날짜 및 시간 (16-19): [references/datetime-reference.md](references/datetime-reference.md) 참조
60
61	상세 패턴을 로드해야 할 때:
62	- 해당 카테고리의 불일치를 감지했을 때 특정 참조 파일을 로드하세요
63	- 포괄적인 분석이 필요한 경우 모든 파일을 로드하세요
64	- 사용자가 특정 표준(예: "정부 공문서 기준")을 언급하면 해당 참조를 로드하세요
65	- 텍스트가 이미 일관적이면 로드를 건너뛰세요
66
67	---
68
69	## 장르 매트릭스 (7 카테고리 × 4 문서 타입)
70
71	같은 카테고리도 문서 타입에 따라 권장 기준이 다릅니다. 다음 매트릭스를 적용해 차등 검사하세요. 매트릭스에 없는 미세 케이스는 다수결 원칙을 적용합니다.
72
73	\| 카테고리 \| 비즈니스/공문서 \| 학술 논문 \| 기술 문서 \| 마케팅/블로그 \|
74	\|---\|---\|---\|---\|---\|
75	\| 1. 어조·격식 \| ~합니다 (해요체) \| ~이다 (한다체) \| ~합니다 + ~한다 혼용 \| ~해요/~다 자유, 친근함 \|
76	\| 2. 용어 \| 표준 한국어 (사용자/데이터베이스) \| 학술 용어 + 영어 원어 병기 \| IT 용어 (API/SDK), 영어 약어 OK \| 브랜드 용어 + 친근한 말 \|
77	\| 3. 숫자·단위 \| 아라비아 + 단위 띄어쓰기(`5 명`) \| 엄격 (`3명`, 아라비아) \| 자유 (`5명` 또는 `5 명`) \| 자유 \|
78	\| 4. 목록 구조 \| 완전체 종결(`~합니다`), 1./2. 번호 \| 명사구 또는 `~함`, 한자어 OK \| 자유 (불릿/번호 혼용) \| 자유, 이모지 허용 \|
79	\| 5. 인용·강조 \| 큰따옴표(`""`), 굵게 보수적 \| APA/MLA 정형 \| 인라인 코드 우선, 굵게 자유 \| 자유 (`""`, `''`, 이모지 강조) \|
80	\| 6. 날짜·시간 \| `YYYY년 MM월 DD일`, 24시간제 \| 동일 (학술도 한글 형식 우세) \| `YYYY-MM-DD` ISO, 24시간 \| 자유 (`'26.5.2`, `5/2`) \|
81	\| 7. 링크·참조 \| 명시적 텍스트 \| 각주·참고문헌 정형 \| `[제목](URL)` 인라인 \| 자유, 이미지 임베드 \|
82
83	매트릭스 사용 규칙:
84	- 셀의 권장은 디폴트 — 사용자가 명시한 브랜드/프로젝트 가이드가 있으면 그것이 우선
85	- 혼합 타입: 입력이 두 타입에 걸쳐 있으면 더 격식 높은 쪽 기준 적용 (예: 비즈니스 + 마케팅 합본 → 비즈니스 기준)
86	- 차등 우선순위: 마케팅/블로그에서는 우선순위 1(어조 일관성) 검사가 완화될 수 있음. 학술에서는 우선순위 4(인용 형식)도 우선순위 1만큼 엄격하게 검사
87	- 권위 출처 vs 매트릭스: 사용자가 권위 표준(예: APA, 정부 가이드)을 명시하면 그것이 매트릭스 셀보다 우선
88
89	각 카테고리의 세부 항목은 `references/[카테고리].md`의 "장르별 권장 사항" 섹션 참조.
90
91	---
92
93	## 작업 흐름
94
95	### 1단계: 텍스트 받기 및 문서 타입 결정
96
97	텍스트 입력:
98	- 파일 경로가 주어지면 Read 도구를 사용하여 로드합니다
99	- 텍스트가 대화 컨텍스트에 있으면 추출합니다
100	- 여러 파일이 제공되면 프로젝트 전체 일관성을 검사합니다
101
102	문서 타입 결정 (3단계 우선순위):
103
104	1. 사용자 명시 우선: 입력에 "학술 논문", "비즈니스 보고서", "기술 문서", "블로그 글" 같은 명시 키워드가 있으면 그것을 사용
105	2. 자동 추정: 첫 300자에서 어조(~합니다 vs ~이다 vs ~해요), 용어 밀도, 인용 형식, 호격 사용 등으로 추정
106	3. 신뢰도 낮으면 명시 요청: 추정 신뢰도가 낮은 경우(짧은 텍스트, 모호한 어조, 혼합 형태) AskUserQuestion으로 4가지 중 선택 요청
107
108	4가지 문서 타입:
109	- 비즈니스/공문서: 격식체, 표준 용어, 일관된 날짜 형식
110	- 학술 논문: 엄격한 인용 형식, 전문 용어, 형식적 어조
111	- 기술 문서: IT 용어 통일, 코드 블록 스타일, 간결한 표현
112	- 마케팅/블로그: 브랜드 보이스, 독자 친화적 어조, 유연한 표현
113
114	결정된 타입은 §장르 매트릭스에 따라 카테고리별 기준 적용.
115
116	### 2단계: 7가지 카테고리 분석
117
118	우선순위 순서로 체계적으로 확인합니다:
119
120	우선순위 1 (최고): 어조 및 격식
121	- 경어체 혼용 (입니다 ↔ 이에요 ↔ 임)
122	- 주어 불일치 (우리 ↔ 저희)
123	- 문체 충돌 (격식 ↔ 구어체)
124
125	우선순위 2 (높음): 용어 통일
126	- 동일 개념 다른 표현 (사용자 ↔ 유저 ↔ 이용자)
127	- 외래어 표기 (웹사이트 ↔ 웹 사이트)
128	- 약어 사용 (데이터베이스 ↔ DB)
129
130	우선순위 3 (중간): 숫자/단위, 목록
131	- 숫자 표기 (3개 ↔ 세 개)
132	- 단위 띄어쓰기 (10 개 ↔ 10개)
133	- 목록 부호 (1. ↔ - ↔ •)
134	- 목록 종결어미 (합니다 ↔ 함 ↔ 생략)
135
136	우선순위 4 (낮음): 인용, 날짜, 링크
137	- 따옴표 ("" ↔ '' ↔ 「」)
138	- 날짜 형식 (2026년 1월 27일 ↔ 2026.01.27)
139	- 링크 스타일 (여기 클릭 ↔ [제목](URL))
140
141	감지한 카테고리에 해당하는 상세 참조 파일을 로드하세요. 각 reference 파일에는 "장르별 권장 사항" 섹션이 있어 4가지 문서 타입별 기준을 제공합니다. 1단계에서 결정된 문서 타입과 §장르 매트릭스를 참조해 적용 기준을 결정하세요.
142
143	### 3단계: 불일치 식별 및 분석
144
145	감지된 각 불일치에 대해:
146	- 빈도 계산: 각 표현이 문서에 몇 번 등장하는지 세기
147	- 다수결 원칙: 가장 많이 사용된 표현을 기준으로 제안
148	- 문맥 고려: 문서 타입에 더 적합한 표현 판단
149	- 권위 출처: 해당되는 경우 표준 가이드(정부/학술/실무) 참조
150
151	### 4단계: 통일안 제시
152
153	- 다수결 기준: "사용자"(5회) vs "유저"(2회) → "사용자"로 통일
154	- 표준 우선: 공문서는 정부 표준, 논문은 학술 관례 우선
155	- 사용자 선호:

People who liked this also viewed

6 picks

Type