omd-apply

Name: omd-apply
Author: kwakseongjae

365stars35forks

How to install omd-apply?

kwakseongjae/oh-my-design/omd-apply

$npx -y skills add kwakseongjae/oh-my-design --skill omd-apply

Installs into the current project.

Summary

프로젝트 DESIGN.md를 UI/시각 작업의 brand context로 적용. 컴포넌트·색상·폰트·레이아웃 수정 같은 구체적 요청과 톤·분위기 표현 — KR '좀 더 따뜻하게', EN 'make it warmer/cooler', 日本語「もう少し暖かく」, 繁體中文「更溫暖一點」 — 모두에 트리거. DESIGN.md 부재 시 omd:init 우선. 화면 전체 신규 디자인은 omd:harness, 교정 기록은 omd:remember.

Files · 1

View on GitHub

SKILL.md

1	<!-- omd:installed-skill — managed by `omd install-skills`. Do not edit; rerun the command to refresh. -->
2
3
4	# omd:apply — Brand Context Injection + Dispatch Router
5
6	DESIGN.md를 모든 UI/디자인 작업의 권위 있는 컨텍스트로 사용한다. 단일 책임은 두 가지:
7
8	1. 인라인 처리 — 작은 단일 변경 (1 component, 1 token, 1 카피 라인)은 직접 Edit 툴로 처리
9	2. Dispatch — 복합 작업은 적합한 서브에이전트로 즉시 라우팅 (master 거치지 않음)
10
11	복합 작업을 인라인으로 처리하면 안 된다. 이 스킬의 가장 중요한 책임은 언제 dispatch할지 정확히 판단하는 것.
12
13	## 트리거 조건
14
15	다음 중 하나가 감지되면 SKILL 전체를 로드한다.
16
17	- 컴포넌트 생성 / 수정 (button, card, dialog, nav, form 등)
18	- 스타일 변경 (Tailwind 클래스, CSS, 토큰 값)
19	- 마이크로카피 작성 / 수정 (버튼 라벨, empty state, 에러, tooltip)
20	- 모션 / 트랜지션 추가
21	- 색상 · 타이포그래피 · 스페이싱 조정
22	- 에셋 (아이콘, 차트, 일러스트, 3D 렌더) 요청
23	- 디자인 시스템 관련 질문
24
25	## Phase 0 — Dispatch decision tree (가장 먼저)
26
27	작업 시작 전에 어떤 처리 경로인지 결정한다. 다음 표를 위에서부터 순차 매칭, 첫 번째 매칭 행으로 진행:
28
29	\| 사용자 요청 패턴 \| 처리 경로 \| 이유 \|
30	\|---\|---\|---\|
31	\| "에셋 / 아이콘 / 일러스트 / 차트 / 사진 / 로고 / 그래프 / SVG 만들어" \| dispatch `omd-asset-curator` \| 매체 선택 + 스택 매칭이 전문 영역 \|
32	\| "메인 화면 / landing / 전체 디자인 / 처음부터 / 와이어프레임" \| 사용자에게 `/omd-harness` 추천 \| 10-phase 파이프라인이 적합 \|
33	\| "접근성 / a11y / 색약 / 키보드 네비" 감사 \| dispatch `omd-a11y-auditor` \| 전문 감사 \|
34	\| "마이크로카피만 다듬어 / 카피 톤 정리 / empty state 문구 전부" 복수 \| dispatch `omd-microcopy` \| voice 일관성 \|
35	\| "사용자 시나리오 / 페르소나 walk through / 4명 입장에서 검토" \| dispatch `omd-persona-tester` \| adversarial 4-페르소나 \|
36	\| "이 카피 좋은지 / hero 카피 약점 / 섹션별 카피 전문가 의견 / A/B 후보" \| dispatch `omd-ux-writer` \| UX writing 분석 + 대안 + 근거 \|
37	\| "이 인터랙션 / 모션 / 포커스 / 모바일 / 지각 성능 / 섹션별 UX 약점" \| dispatch `omd-ux-engineer` \| 코드 레벨 인터랙션 감사 + fix \|
38	\| "랜딩 / 메인 화면 / 페이지 전체를 전문가 의견으로 개선" \| dispatch `omd-ux-writer` + `omd-ux-engineer` (병렬) \| 두 트랙 동시 — writing + engineering \|
39	\| "이게 왜 안 좋은지 critique / postmortem / root cause" \| dispatch `omd-critic` \| 비판적 분석 \|
40	\| "DESIGN.md 만들어 / reference 골라 / 카탈로그에서 추천" \| dispatch `omd-init` skill (또는 omd-add-reference) \| reference 매칭 \|
41	\| "preference 정리 / 누적된 교정 반영 / DESIGN.md 업데이트" \| dispatch `omd-learn` skill \| fold-in 로직 \|
42	\| "이 한 줄 / 이 컬러 / 이 spacing 좀" 단발 명확 \| 인라인 처리 \| 분명한 단일 변경 \|
43	\| 위 어디에도 안 맞는 자유로운 디자인 작업 \| 인라인 처리 후 Phase 3 (교정 캡처) \| 일반 케이스 \|
44
45	dispatch가 정해지면 즉시 Agent 툴 호출 (master 경유 X — 우리가 omd-apply로 트리거됐다는 건 master 컨텍스트 밖이라는 의미). 그 후 인라인 처리는 하지 않고, 서브에이전트가 반환한 결과를 사용자에게 정리만 해서 전달.
46
47	## Phase 1 — DESIGN.md 로드 (인라인 처리 분기 한정)
48
49	dispatch가 아니라 인라인 처리로 분기됐을 때만 진행:
50
51	1. 프로젝트 루트의 `DESIGN.md`를 전체 읽는다. 요약 금지, Read 툴로 직접 로드.
52	2. `.omd/preferences.md`가 있으면 같이 읽는다. `status: pending` 엔트리는 아직 DESIGN.md에 반영 안 된 교정 — DESIGN.md보다 우선 적용.
53	3. reference-capture 자료가 있으면 함께 로드: `DESIGN.md` frontmatter의 `bootstrapped_from` 또는 `.omd/init-context.json`의 `reference_id`로 brand id를 얻고, `assets/_reference/<id>/`가 존재하면:
54	- `tokens.json` — `live_overrides` 블록 우선
55	- `structure.json` — composition cues (hero/cta/nav idiom)
56	- `fonts.json` — `live_observed: true` 항목은 출력 HTML `<head>`에 `html_link` 그대로 박을 것. 미로드 시 시스템 fallback으로 둥근 폰트 mismatch.
57	- `screenshots/hero-desktop.png` — UI 작업이 hero/landing 류면 Read 툴로 이미지로 직접 읽고 시각 grounding
58	- mode 분기 (`.omd/init-context.json`의 `mode` 필드):
59	- `clone` → 헤더 logo는 `assets/_reference/<id>/logo.<ext>` 직접 사용. project root에 `CLONE-MODE.md` + `replace-checklist.md`가 있어야 함.
60	- `inspired` (또는 미지정) → 헤더 logo는 `[YOUR LOGO]` placeholder. captured 자산은 product DOM 미사용.
61	4. 우선순위:
62	```
63	.omd/preferences.md (pending)
64	> assets/_reference/<id>/tokens.json#live_overrides (visual surface tokens만)
65	> DESIGN.md (essence: voice/principles/motion 철학·canonical token)
66	> framework defaults
67	```
68	essence (voice/principles/motion philosophy)는 항상 DESIGN.md가 권위. visual surface 토큰만 live_overrides가 우위.
69
70	DESIGN.md 없으면 사용자에게 알리고 omd:init 스킬 트리거. 임의 생성 금지.
71
72	## Phase 2 — Brand Context 적용
73
74	- 토큰 값은 DESIGN.md에서만 인용. 임의 hex / spacing / radius 금지.
75	- Voice 섹션을 마이크로카피에 적용. 문장 길이, 어휘 register, 은유 밀도 일치.
76	- Component 섹션 명시된 규칙 따름 (variant / state / sizes).
77	- 없는 토큰 지어내지 않음. 필요 시 사용자에게 "이건 DESIGN.md에 없는데, 어떻게 할까요?" 묻기.
78
79	## Phase 3 — 교정 캡처
80
81	턴 종료 전에 다음 중 하나가 있었는지 확인:
82
83	1. 사용자가 디자인 선택을 명시적 교정 ("no, use X", "actually, Y", "don't use Z", "we never do W")
84	2. 사용자가 토큰/값을 revert 또는 교체
85	3. 사용자가 "우리는 ~한다/하지 않는다" 형태 원칙 언급
86
87	감지되면 omd:remember 스킬을 트리거한다 (CLI 호출 X — `.omd/preferences.md`에 직접 append). 트리거 메서드: omd-remember SKILL.md의 Step 1-6 절차를 따라 Edit 툴로 파일 수정.
88
89	## Phase 4 — 확인 메시지
90
91	교정 기록 시 턴 끝에 한 줄:
92
93	```
94	Logged to .omd/preferences.md — say "preference 정리해줘" later to fold into DESIGN.md.
95	```
96
97	일반 작업에는 불필요. 과한 알림 금지.
98
99	## 금지
100
101	- DESIGN.md 없는데 임의 생성 금지 (사용자에게 omd:init 제안)
102	- 복합 작업을 인라인으로 처리 금지 (Phase 0 dispatch table 따라 라우팅)
103	- 교정 감지 시 "기록할까요?" 묻지 말 것 — 자동 기록 + 한 줄 알림
104	- 같은 턴 내 같은 교정 중복 기록 금지
105	- CLI 호출 (`omd remember`, `omd learn` 등) 금지 — 1.0.0부터 모두 스킬 prose

People who liked this also viewed

6 picks

Type

omd-apply

365stars35forks

View on GitHub

How to install omd-apply?

kwakseongjae/oh-my-design/omd-apply

$npx -y skills add kwakseongjae/oh-my-design --skill omd-apply

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	<!-- omd:installed-skill — managed by `omd install-skills`. Do not edit; rerun the command to refresh. -->
2
3
4	# omd:apply — Brand Context Injection + Dispatch Router
5
6	DESIGN.md를 모든 UI/디자인 작업의 권위 있는 컨텍스트로 사용한다. 단일 책임은 두 가지:
7
8	1. 인라인 처리 — 작은 단일 변경 (1 component, 1 token, 1 카피 라인)은 직접 Edit 툴로 처리
9	2. Dispatch — 복합 작업은 적합한 서브에이전트로 즉시 라우팅 (master 거치지 않음)
10
11	복합 작업을 인라인으로 처리하면 안 된다. 이 스킬의 가장 중요한 책임은 언제 dispatch할지 정확히 판단하는 것.
12
13	## 트리거 조건
14
15	다음 중 하나가 감지되면 SKILL 전체를 로드한다.
16
17	- 컴포넌트 생성 / 수정 (button, card, dialog, nav, form 등)
18	- 스타일 변경 (Tailwind 클래스, CSS, 토큰 값)
19	- 마이크로카피 작성 / 수정 (버튼 라벨, empty state, 에러, tooltip)
20	- 모션 / 트랜지션 추가
21	- 색상 · 타이포그래피 · 스페이싱 조정
22	- 에셋 (아이콘, 차트, 일러스트, 3D 렌더) 요청
23	- 디자인 시스템 관련 질문
24
25	## Phase 0 — Dispatch decision tree (가장 먼저)
26
27	작업 시작 전에 어떤 처리 경로인지 결정한다. 다음 표를 위에서부터 순차 매칭, 첫 번째 매칭 행으로 진행:
28
29	\| 사용자 요청 패턴 \| 처리 경로 \| 이유 \|
30	\|---\|---\|---\|
31	\| "에셋 / 아이콘 / 일러스트 / 차트 / 사진 / 로고 / 그래프 / SVG 만들어" \| dispatch `omd-asset-curator` \| 매체 선택 + 스택 매칭이 전문 영역 \|
32	\| "메인 화면 / landing / 전체 디자인 / 처음부터 / 와이어프레임" \| 사용자에게 `/omd-harness` 추천 \| 10-phase 파이프라인이 적합 \|
33	\| "접근성 / a11y / 색약 / 키보드 네비" 감사 \| dispatch `omd-a11y-auditor` \| 전문 감사 \|
34	\| "마이크로카피만 다듬어 / 카피 톤 정리 / empty state 문구 전부" 복수 \| dispatch `omd-microcopy` \| voice 일관성 \|
35	\| "사용자 시나리오 / 페르소나 walk through / 4명 입장에서 검토" \| dispatch `omd-persona-tester` \| adversarial 4-페르소나 \|
36	\| "이 카피 좋은지 / hero 카피 약점 / 섹션별 카피 전문가 의견 / A/B 후보" \| dispatch `omd-ux-writer` \| UX writing 분석 + 대안 + 근거 \|
37	\| "이 인터랙션 / 모션 / 포커스 / 모바일 / 지각 성능 / 섹션별 UX 약점" \| dispatch `omd-ux-engineer` \| 코드 레벨 인터랙션 감사 + fix \|
38	\| "랜딩 / 메인 화면 / 페이지 전체를 전문가 의견으로 개선" \| dispatch `omd-ux-writer` + `omd-ux-engineer` (병렬) \| 두 트랙 동시 — writing + engineering \|
39	\| "이게 왜 안 좋은지 critique / postmortem / root cause" \| dispatch `omd-critic` \| 비판적 분석 \|
40	\| "DESIGN.md 만들어 / reference 골라 / 카탈로그에서 추천" \| dispatch `omd-init` skill (또는 omd-add-reference) \| reference 매칭 \|
41	\| "preference 정리 / 누적된 교정 반영 / DESIGN.md 업데이트" \| dispatch `omd-learn` skill \| fold-in 로직 \|
42	\| "이 한 줄 / 이 컬러 / 이 spacing 좀" 단발 명확 \| 인라인 처리 \| 분명한 단일 변경 \|
43	\| 위 어디에도 안 맞는 자유로운 디자인 작업 \| 인라인 처리 후 Phase 3 (교정 캡처) \| 일반 케이스 \|
44
45	dispatch가 정해지면 즉시 Agent 툴 호출 (master 경유 X — 우리가 omd-apply로 트리거됐다는 건 master 컨텍스트 밖이라는 의미). 그 후 인라인 처리는 하지 않고, 서브에이전트가 반환한 결과를 사용자에게 정리만 해서 전달.
46
47	## Phase 1 — DESIGN.md 로드 (인라인 처리 분기 한정)
48
49	dispatch가 아니라 인라인 처리로 분기됐을 때만 진행:
50
51	1. 프로젝트 루트의 `DESIGN.md`를 전체 읽는다. 요약 금지, Read 툴로 직접 로드.
52	2. `.omd/preferences.md`가 있으면 같이 읽는다. `status: pending` 엔트리는 아직 DESIGN.md에 반영 안 된 교정 — DESIGN.md보다 우선 적용.
53	3. reference-capture 자료가 있으면 함께 로드: `DESIGN.md` frontmatter의 `bootstrapped_from` 또는 `.omd/init-context.json`의 `reference_id`로 brand id를 얻고, `assets/_reference/<id>/`가 존재하면:
54	- `tokens.json` — `live_overrides` 블록 우선
55	- `structure.json` — composition cues (hero/cta/nav idiom)
56	- `fonts.json` — `live_observed: true` 항목은 출력 HTML `<head>`에 `html_link` 그대로 박을 것. 미로드 시 시스템 fallback으로 둥근 폰트 mismatch.
57	- `screenshots/hero-desktop.png` — UI 작업이 hero/landing 류면 Read 툴로 이미지로 직접 읽고 시각 grounding
58	- mode 분기 (`.omd/init-context.json`의 `mode` 필드):
59	- `clone` → 헤더 logo는 `assets/_reference/<id>/logo.<ext>` 직접 사용. project root에 `CLONE-MODE.md` + `replace-checklist.md`가 있어야 함.
60	- `inspired` (또는 미지정) → 헤더 logo는 `[YOUR LOGO]` placeholder. captured 자산은 product DOM 미사용.
61	4. 우선순위:
62	```
63	.omd/preferences.md (pending)
64	> assets/_reference/<id>/tokens.json#live_overrides (visual surface tokens만)
65	> DESIGN.md (essence: voice/principles/motion 철학·canonical token)
66	> framework defaults
67	```
68	essence (voice/principles/motion philosophy)는 항상 DESIGN.md가 권위. visual surface 토큰만 live_overrides가 우위.
69
70	DESIGN.md 없으면 사용자에게 알리고 omd:init 스킬 트리거. 임의 생성 금지.
71
72	## Phase 2 — Brand Context 적용
73
74	- 토큰 값은 DESIGN.md에서만 인용. 임의 hex / spacing / radius 금지.
75	- Voice 섹션을 마이크로카피에 적용. 문장 길이, 어휘 register, 은유 밀도 일치.
76	- Component 섹션 명시된 규칙 따름 (variant / state / sizes).
77	- 없는 토큰 지어내지 않음. 필요 시 사용자에게 "이건 DESIGN.md에 없는데, 어떻게 할까요?" 묻기.
78
79	## Phase 3 — 교정 캡처
80
81	턴 종료 전에 다음 중 하나가 있었는지 확인:
82
83	1. 사용자가 디자인 선택을 명시적 교정 ("no, use X", "actually, Y", "don't use Z", "we never do W")
84	2. 사용자가 토큰/값을 revert 또는 교체
85	3. 사용자가 "우리는 ~한다/하지 않는다" 형태 원칙 언급
86
87	감지되면 omd:remember 스킬을 트리거한다 (CLI 호출 X — `.omd/preferences.md`에 직접 append). 트리거 메서드: omd-remember SKILL.md의 Step 1-6 절차를 따라 Edit 툴로 파일 수정.
88
89	## Phase 4 — 확인 메시지
90
91	교정 기록 시 턴 끝에 한 줄:
92
93	```
94	Logged to .omd/preferences.md — say "preference 정리해줘" later to fold into DESIGN.md.
95	```
96
97	일반 작업에는 불필요. 과한 알림 금지.
98
99	## 금지
100
101	- DESIGN.md 없는데 임의 생성 금지 (사용자에게 omd:init 제안)
102	- 복합 작업을 인라인으로 처리 금지 (Phase 0 dispatch table 따라 라우팅)
103	- 교정 감지 시 "기록할까요?" 묻지 말 것 — 자동 기록 + 한 줄 알림
104	- 같은 턴 내 같은 교정 중복 기록 금지
105	- CLI 호출 (`omd remember`, `omd learn` 등) 금지 — 1.0.0부터 모두 스킬 prose

People who liked this also viewed

6 picks

Type