Skip to main content
ClaudeWave
Skill261 repo starsupdated 1mo ago

detail-page-planner

detail-page-planner is a strategic planning skill that creates briefs for e-commerce product detail pages by defining a single core message, selecting from four opening approaches based on product maturity and visual strength, and structuring body content with differentiated USPs and visual hierarchy. Use this skill as the first step when planning detail pages for new or redesigned products, before copywriting, coding, or image production begins.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/modu-ai/cowork-plugins /tmp/detail-page-planner && cp -r /tmp/detail-page-planner/moai-content/skills/detail-page-planner ~/.claude/skills/detail-page-planner
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 상세페이지 기획자 (Detail Page Planner)

## 책임 경계

| 단계 | 스킬 | 산출물 |
|------|------|--------|
| 1. 기획·전략 (★ **본 스킬**) | `moai-content:detail-page-planner` | **Brief** (원 메시지·오프닝·본문 뼈대·채널·이미지 체크리스트) |
| 2. 카피 | `moai-commerce:detail-page-copy` | 13섹션 감정여정 JSON |
| 3. 코드 | `moai-content:product-detail` | shadcn/ui React 또는 HTML |
| 4. 이미지 | `moai-commerce:detail-page-image` | 1080×12720 합성 PNG |

**본 스킬은 1번만 담당** — 카피·코드·이미지는 위임. Brief가 후속 3개 스킬의 입력.

## 트리거 키워드

상세페이지 기획, 상세페이지 구조, 원 메시지, 오프닝 4유형, 본문 뼈대, 유통 채널 분기, 펀딩 vs 커머스, 카테고리 사진 체크리스트, 상세페이지 전략, 상폐 기획

## 5대 기획 모듈

### 모듈 1 — One Message 프레임워크 ★ 핵심

**원 메시지** = 상세페이지가 전달할 단 하나의 메시지. 모든 콘텐츠가 이걸 뒷받침해야 한다.

3단 정합 구조:
```
브랜드 컨셉  →  원 메시지  →  이미지·색·글 3요소
```

같은 제품이라도 **타깃에 따라 원 메시지 분기**:

```
원목 수납장 손잡이 예시:
  타깃 A "튼튼함 우선"  → "20kg를 견디는 손잡이"
  타깃 B "예쁨 우선"    → "방의 분위기를 바꾸는 손잡이"
  타깃 C "안전 우선"    → "아이가 매달려도 안전한 손잡이"
```

산출물: `[원 메시지 - 카피 - 설명글]` 세트

```yaml
one_message:
  brand_concept: "{브랜드가 추구하는 본질 한 문장}"
  message: "{원 메시지 한 문장}"
  copy: "{메시지를 강화하는 헤드라인 카피}"
  description: "{메시지를 풀어 설명하는 본문 도입글}"
```

색 체계:
- 브랜드 색 (전체 일관성)
- 상품페이지 컨셉 색 (각 페이지 분위기)
- 두 색을 분리해 운영

이미지 선택 기준:
- **사진 이미지**: 실제 보이는 특징 (텍스처·크기·색)
- **디자인 이미지**: 보이지 않는 특징·컨셉(작동 원리·라이프스타일)

자세한 카테고리별 사진은 → `references/photo-checklist.md`

---

### 모듈 2 — 오프닝 4유형 분기 ★ 핵심

UX 데이터 근거: **3초 = 스크롤 3번**. 어텐션 그래프상 "오프닝 > 본문 > 클로징" 순서로 우선순위.

#### 유형 진단 트리

```
제품이 시장에 처음 나왔는가?
├─ YES → 첫 만남형
└─ NO ↓
    제품 자체가 시각적으로 강한가? (예쁨·독특함)
    ├─ YES → 스타형
    └─ NO ↓
        타깃의 페인포인트가 명확한가?
        ├─ YES → 공감형
        └─ NO  → 매력형 (혜택·가성비 강조)
```

#### 유형별 인트로 3 step 템플릿

| 유형 | Step 1 | Step 2 | Step 3 | 예시 |
|---|---|---|---|---|
| **첫 만남형** | "이런 제품 본 적 있나요?" | 핵심 USP 정의 | 가치 예고 | 3 in 1 마우스 |
| **스타형** | 제품 시각 임팩트 | 제품명·디자인 강조 | 사용 장면 | 빨아 입는 수트 |
| **매력형** | 매력 포인트 1 | 매력 포인트 2 | "지금 결정해야 하는 이유" | (혜택·가성비) |
| **공감형** | "이런 고민 있죠?" | 페인포인트 구체화 | "이 제품이 해결" | (페인 해소) |

총 12개 작성 패턴. 직접 LLM 프롬프트에 인용 가능.

---

### 모듈 3 — 본문 4단계 + 3 미션 체크

#### 4단계 본문 기획 프로세스

```
[1] 인트로     → 모듈 2의 4유형 인트로 적용
[2] 요약 콘텐츠 → 한눈에 보는 USP 1~3개
[3] 소제목 뼈대 → 스캐너 + 검색 고객 동시 대응
[4] 시각 자료  → 모듈 1의 사진/디자인 분기
```

#### 3 미션 체크리스트 (본문 작성 전)

- [ ] **진짜 차별점**이 명확한가? (경쟁 제품 대비)
- [ ] 고객이 **갈아타게** 만드는 이유가 있는가?
- [ ] **생생한 간접 경험**이 들어 있는가? (사용 장면·후기·실측)

#### 본문 USP 정리 공식

```
본문 = 대표 USP 2~3개 + 좋은 제품 특징 2~3개 + 신뢰도/옵션 정보
```

#### "어려운 성분 → 사용자 시각 표현" 3단계 변환

```
[1] 성분 명사     → "히알루론산"
[2] 특징 키워드   → "수분 보유"
[3] 사용자 체감 문장 → "오후 4시에도 촉촉"
```

#### 한국 광고 심의 가드 (카테고리 분기)

- 화장품: 재생·치료·세포 등 의약품 표현 금지 → `references/category-beauty.md`
- 식품: 효능 단정 표현 주의 → `references/category-food.md`
- 패션·생활: 비교 우위 단정 주의

---

### 모듈 4 — 유통 채널 분기 ★ 차별화

펀딩 vs 커머스(오픈마켓)의 사용자 행태가 다르다 — UX 데이터 근거:
- 커머스 사용자는 **체류시간 1/3 단축**
- 스크롤 도달률 **2,000px 짧음**

#### 채널 분기 트리

| 채널 | 사용자 행태 | 본문 전략 |
|---|---|---|
| **펀딩(와디즈·텀블벅)** | 탐색형, 스토리 OK | 인트로 길게, 공감·사회 이슈 OK, 4유형 모두 가능 |
| **커머스(스마트스토어·쿠팡·카카오)** | 목적형, 즉시 판단 | **딴소리 제거**, 제품 특징 즉시 노출, 매력형/스타형 우선 |

#### 커머스 상세페이지 뼈대 템플릿

```
[1] 특징 (USP 즉시 노출)
[2] 차별점 (3 in 3, 경쟁 제품 비교)
[3] 후기 (실사용·평점·이미지)
[4] CTA (구매·찜·문의)
```

#### 4단계 타깃 재정의 프로세스

```
[1] 트렌드 파악         → 카테고리 시장 흐름
[2] 새 타깃 정의        → 구체 페르소나 1~2명
[3] 라이프스타일 매핑    → 일상 시나리오 5개
[4] 마케팅 플랜 일치    → 광고·SNS·검색 통합
```

---

### 모듈 5 — 카테고리별 사진 체크리스트

**9 카테고리 × 가까운/먼** 사진별 필수 항목 → `references/photo-checklist.md`

| 카테고리 | 가까운 (Close) | 먼 (Wide) |
|---|---|---|
| 패션 | 원단 클로즈업·부자재·디자인 디테일 | 전신 착장·코디 룩 |
| 푸드 | 단면·원물·조리예 | 식탁 컨텍스트 |
| 뷰티 | 제형·발색·흡수 | 사용 장면·전후 |
| B2B/SaaS | UI 캡처·데이터 시각화 | 화면 전체·팀 사용 장면 |
| 구독 | 박스 개봉·내용물 클로즈업 | 월별 큐레이션·생활 컷 |
| 베이비/키즈 | 안전 인증·소재 | 연령별 사용 시나리오 |
| 디지털 콘텐츠 | UI 미리보기·강의 캡처 | 학습 환경·결과물 |
| 펫 | 사료 알갱이·성분표 | 반려동물 사용 장면 |
| 여행 | 객실·메뉴 디테일 | 풍경·동선·체험 컷 |

추가 4종 (스포츠/명품 등)은 photo-checklist.md 참조.

#### 사진 없이 상세페이지 기획 5단계 (사진 촬영 전)

```
[1] 원 메시지 결정 (모듈 1)
[2] 특징 3~5개 추출
[3] 각 특징별 사진 종류 결정 (가까운/먼/디자인)
[4] 사진 vs gif 결정
[5] 흐름 짜기 (PowerPoint 워크플로우)
```

---

## 워크플로우 (전체 흐름)

```
사용자 요청 입력
  ↓
[Step 1] 카테고리 진단 (패션/푸드/테크/뷰티/리빙/기타)
  ↓
[Step 2] 채널 진단 (펀딩 vs 커머스) → 모듈 4 분기
  ↓
[Step 3] 모듈 1: One Message 잡기
  ↓
[Step 4] 모듈 2: 오프닝 유형 진단 + 3 step 인트로 작성
  ↓
[Step 5] 모듈 3: 본문 4단계 뼈대 + 3 미션 체크 + 광고 심의 가드 적용
  ↓
[Step 6] 모듈 5: 카테고리별 사진 체크리스트
  ↓
[Step 7] Brief 산출 (YAML/Markdown) → 후속 스킬 입력
```

## Brief 산출 형식

```yaml
brief:
  category: "{패션|푸드|테크|뷰티|리빙}"
  channel: "{펀딩|커머스}"

  one_message:
    brand_concept: "..."
    message: "..."
    copy: "..."
    description: "..."

  opening:
    type: "{첫 만남형|스타형|매력형|공감형}"
    step1: "..."
    step2: "..."
    step3: "..."

  body_skeleton:
    intro: "(모듈 2 적용)"
    summary_usp: ["...", "...", "..."]
    sub_headings: ["...", "...", "..."]
    visual_notes: "(사진/디자인 분기)"

  three_missions:
    real_differentiation: true
    switch_motivation: true
    vivid_indirect_experience: true

  channel_strategy:
    funding_or_commerce: "..."
    body_template: "..."
    target_redefinition:
      trend: "..."
      persona: "..."
      lifestyle: "..."
      marketing_plan: "..."

  photo_checklist:
    close_shots: [...]
    wide_shots: [...]
    gif_or_static: "..."

  ad_compliance_warnings:
    - "..."
```

후속 스킬 호출:
```
1. brief 산출 후 → moai-commerce:detail-page-copy "Brief: <yaml>"
2. 카피 JSON 산출 후 → moai-content:product-detail "Brief + Copy"
3. 코드 산출 후 → moai-commerce:detail-page-image "Brief + Copy + Code"
```

## 사용 예시

### 예시 1 — 자연어 한 줄

```
"신규 비건 비누 상세페이지 기획해줘. 와디즈 펀딩으로 출시 예정."
```

→ Step 1: 카테고리 = 뷰티 (비누) → `references/category-beauty.md` 자동 로드
→ Step 2: 채널 = 펀딩 → 인트로 길게 OK, 공감형/스타형 우선
→ Step 3: One Message — "5가지 식물 추출물로 만든 24시간 보습 비누"
→ Step 4: 오프닝 = 공감형 ("건성 피부 한겨울 가려움" → 페인포인트 → 식물 추출물 해결)
→ Step 5-6: 본문 4단계 + 사진 체크리스트
→ Step 7: Brief YAML 산출

### 예시 2 — 채널·카테고리 미정

```
"화장품 상세페이지 기획"
```

→ AskUserQuestion 1라운드:
   - Q1: 카테고리 세부 (스킨케어·메이크업·헤어 등)
   - Q2: 채널 (펀딩/커머스)
→ 답변 후 Step 1-7 진행

### 예시 3 — Brief만 받아서 후속 위임

```
"이 Brief로 카피랑 코드까지 다 만들어줘"
+ 첨부: 작성된 Brief YAML
```

→ Step 0: Brief 검증 (모듈 1-5 항목 누락 확인)
→ Brief 완성 후: moai-commerce:detail-page-copy → product-detail → moai-commerce: