Responsibility Boundaries
| Stage | Skill | Deliverable |
|---|---|---|
| 1. Planning & Strategy (★ This Skill) | moai-seller:commerce-detail-page-planner |
Brief (one message, opening, body skeleton, channel, image checklist) |
| 2. Copy | moai-seller:commerce-detail-page-copy |
13-Section Emotional Journey JSON |
| 3. Code | moai-seller:commerce-product-detail |
shadcn/ui React or HTML |
| 4. Image | moai-seller:commerce-detail-page-image |
1080×12720 composite PNG |
This skill handles only No. 1 — copy, code, and images are delegated. The Brief is the input for the three follow-up skills.
Trigger Keywords
detail page planning, detail page structure, one message, 4 opening types, body skeleton, distribution channel branching, funding vs commerce, category photo checklist, detail page strategy, product detail page planning
5 Major Planning Modules
Module 1 — One Message Framework ★ Core
One Message = the single message the detail page will convey. All content must support this.
3-Tier Alignment Structure:
브랜드 컨셉 → 원 메시지 → 이미지·색·글 3요소
Even for the same product, branch the one message by target:
원목 수납장 손잡이 예시:
타깃 A "튼튼함 우선" → "20kg를 견디는 손잡이"
타깃 B "예쁨 우선" → "방의 분위기를 바꾸는 손잡이"
타깃 C "안전 우선" → "아이가 매달려도 안전한 손잡이"
Deliverable: [원 메시지 - 카피 - 설명글] set
one_message:
brand_concept: "{브랜드가 추구하는 본질 한 문장}"
message: "{원 메시지 한 문장}"
copy: "{메시지를 강화하는 헤드라인 카피}"
description: "{메시지를 풀어 설명하는 본문 도입글}"
Color System:
- Brand color (overall consistency)
- Product page concept color (mood of each page)
- Operate the two colors separately
Image Selection Criteria:
- Photo image: actually visible features (texture, size, color)
- Design image: non-visible features/concepts (working principles, lifestyle)
For detailed category-specific photos → references/photo-checklist.md
Module 2 — 4 Opening Type Branching ★ Core
UX data basis: 3 seconds = 3 scrolls. On the attention graph, priority order is "opening > body > closing".
Type Diagnosis Tree
제품이 시장에 처음 나왔는가?
├─ YES → 첫 만남형
└─ NO ↓
제품 자체가 시각적으로 강한가? (예쁨·독특함)
├─ YES → 스타형
└─ NO ↓
타깃의 페인포인트가 명확한가?
├─ YES → 공감형
└─ NO → 매력형 (혜택·가성비 강조)
Intro 3-step template by type
| Type | Step 1 | Step 2 | Step 3 | Example |
|---|---|---|---|---|
| First Encounter Type | "Have you ever seen a product like this?" | Define core USP | Value preview | 3 in 1 mouse |
| Star Type | Product visual impact | Emphasize product name and design | Usage scene | Suit you suck in to wear |
| Charm Type | Charm point 1 | Charm point 2 | "Why you need to decide now" | (benefits, cost-effectiveness) |
| Empathy Type | "You've had concerns like this, right?" | Pain point specification | "This product solves it" | (pain relief) |
A total of 12 writing patterns. Can be quoted directly into LLM prompts.
Module 3 — Body copy 4 steps + 3 mission checks
4-step body copy planning process
[1] 인트로 → 모듈 2의 4유형 인트로 적용
[2] 요약 콘텐츠 → 한눈에 보는 USP 1~3개
[3] 소제목 뼈대 → 스캐너 + 검색 고객 동시 대응
[4] 시각 자료 → 모듈 1의 사진/디자인 분기
3 mission checklist (before writing body copy)
- Real differentiatorIs this clear? (compared with competing products)
- Does the customer switch over have a reason to do so?
- Vivid indirect experienceIs this included? (usage scenes, reviews, actual measurements)
Body copy USP summary formula
본문 = 대표 USP 2~3개 + 좋은 제품 특징 2~3개 + 신뢰도/옵션 정보
"Difficult ingredients → user-perspective expression" 3-step transformation
[1] 성분 명사 → "히알루론산"
[2] 특징 키워드 → "수분 보유"
[3] 사용자 체감 문장 → "오후 4시에도 촉촉"
Korean advertising review guard (category branching)
- Cosmetics: prohibit pharmaceutical expressions such as regeneration, treatment, cells →
references/category-beauty.md - Food: beware of definitive efficacy claims →
references/category-food.md - Fashion/lifestyle: beware of definitive comparative superiority
Module 4 — Distribution channel branching ★ differentiation
User behavior differs between funding vs commerce (open market) — based on UX data:
- Commerce users dwell time reduced by 1/3
- Scroll reach rate 2,000px shorter
Channel branching tree
| Channel | User behavior | Body copy strategy |
|---|---|---|
| Funding (Wadiz, Tumblbug) | Exploratory, story OK | Long intro, empathy/social issues OK, all 4 types possible |
| Commerce (Smart Store, Coupang, Kakao) | Purpose-driven, immediate judgment | Remove digressions, immediately expose product features, prioritize attractive/star types |
Commerce detail page skeleton template
[1] 특징 (USP 즉시 노출)
[2] 차별점 (3 in 3, 경쟁 제품 비교)
[3] 후기 (실사용·평점·이미지)
[4] CTA (구매·찜·문의)
4-step target redefinition process
[1] 트렌드 파악 → 카테고리 시장 흐름
[2] 새 타깃 정의 → 구체 페르소나 1~2명
[3] 라이프스타일 매핑 → 일상 시나리오 5개
[4] 마케팅 플랜 일치 → 광고·SNS·검색 통합
Module 5 — Photo checklist by category
9 categories × close/far Required items per photo → references/photo-checklist.md
| Category | Close | 먼 (Wide) |
|---|---|---|
| Fashion | Fabric close-up, materials, design details | Full-body outfit, coordinated look |
| Food | Cross-section, raw ingredients, cooking example | Dining table context |
| Beauty | Texture, color payoff, absorption | Usage scenes, before and after |
| B2B/SaaS | UI capture, data visualization | Full screen, team usage scene |
| Subscription | Box unboxing, contents close-up | Monthly curation, lifestyle shots |
| Baby/kids | Safety certification, materials | Usage scenarios by age |
| Digital content | UI preview, lecture capture | Learning environment, outcomes |
| 펫 | Feed pellets, ingredient list | Pet usage scenes |
| Travel | Room/menu details | Scenery/route/experience cuts |
For the 4 additional types (sports/luxury, etc.), see photo-checklist.md.
5-step detail page planning without photos (before photo shooting)
[1] 원 메시지 결정 (모듈 1)
[2] 특징 3~5개 추출
[3] 각 특징별 사진 종류 결정 (가까운/먼/디자인)
[4] 사진 vs gif 결정
[5] 흐름 짜기 (PowerPoint 워크플로우)
Workflow (overall flow)
사용자 요청 입력
↓
[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 output format
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:
- "..."
Follow-up skill invocation:
1. brief 산출 후 → moai-seller:commerce-detail-page-copy "Brief: <yaml>"
2. 카피 JSON 산출 후 → moai-seller:commerce-product-detail "Brief + Copy"
3. 코드 산출 후 → moai-seller:commerce-detail-page-image "Brief + Copy + Code"
Usage examples
Example 1 — One line of natural language
"신규 비건 비누 상세페이지 기획해줘. 와디즈 펀딩으로 출시 예정."
→ Step 1: Category = Beauty (soap) → references/category-beauty.md auto-load
→ Step 2: Channel = funding → long intro OK, empathy-type/story-type first
→ Step 3: One Message — "24-hour moisturizing soap made with 5 plant extracts"
→ Step 4: Opening = empathy-type ("dry skin itching in midwinter" → pain point → plant extract solution)
→ Step 5-6: Body 4 steps + photo checklist
→ Step 7: Brief YAML output
Example 2 — Channel/category undecided
"화장품 상세페이지 기획"
→ AskUserQuestion round 1:
- Q1: Category details (skincare, makeup, hair, etc.)
- Q2: Channel (funding/commerce) → After answering, proceed with Steps 1-7
Example 3 — Receiving only a Brief and delegating follow-ups
"이 Brief로 카피랑 코드까지 다 만들어줘"
+ 첨부: 작성된 Brief YAML
→ Step 0: Brief validation (check for missing items in modules 1-5) → After Brief completion: delegate sequentially to moai-seller:commerce-detail-page-copy → commerce-product-detail → moai-seller:commerce-detail-page-image
Relationship with paired skills
Cases where this skill is not used (pair delegation)
- "Make me detail page copy" →
moai-seller:commerce-detail-page-copy(13-section JSON) - "Make me detail page code" →
moai-seller:commerce-product-detail(shadcn/ui component) - "Composite the detail page image" →
moai-seller:commerce-detail-page-image(1080×12720 PNG) - "Make me a landing page" →
moai-marketer:marketing-landing-page(standalone conversion single page)
Cases where this skill is used
- Above pair invocation Previous step — when you need to first decide what to make, in what structure, and in what tone
- When category, channel, and target are ambiguous, making it hard to go straight to copy/code
- When you want to consistently apply Wadiz/commerce best practices
References (separate materials) — covering 9 categories
Common
references/photo-checklist.md— By 9 categories photo checklist + 5-step planning without photosreferences/copy-patterns.md— low-involvement/high-involvement language + 13 pricing strategies + 100 raw copy examples
Category branching (9 types)
| # | references | Apply |
|---|---|---|
| 1 | category-fashion.md |
Clothing, bags, shoes, accessories — 5-step persona + color/font |
| 2 | category-food.md |
Food, beverages, agricultural and marine products — purpose/exploratory type + food review + 4 storytelling |
| 3 | category-beauty.md |
Skincare, makeup, hair, body — body 4 steps + cosmetics law + ingredient conversion |
| 4 | category-b2b-saas.md |
SaaS, solutions, B2B products — pricing page, feature comparison, demo CTA, multiple decision-makers |
| 5 | category-subscription.md |
Subscription boxes, regular delivery, membership — LTV, first-order discount, churn prevention |
| 6 | category-baby-kids.md |
Infant and children's products — safety certification, age branching, parent pain points |
| 7 | category-digital-content.md |
Courses, e-books, newsletters, software — intangible products, experience demos, post-purchase flow |
| 8 | category-pet.md |
Pet food, supplies, services — guardian trust, safe ingredients |
| 9 | category-travel.md |
Travel, hotels, activities — intangible experiences, seasonal branching, booking flow |
| 10 | category-sports-leisure.md |
Camping, running, cycling, golf — activity scenarios, functional specifications |
| 11 | category-luxury.md |
Luxury, high-end — formal tone, whitespace, conciseness, authenticity |
For other categories (automotive, real estate, finance, medical devices, etc.), a separate domain skill is recommended.
Restrictions
- This skill does not directly produce code, copy, or images — Brief output only. Calling the follow-up paired skill is required.
- Korean market specialization (Wadiz, Smart Store, Coupang, Kakao specifications). Global markets require a separate guide.
- Advertising review guard is based on 2024 — it may change, so regular updates to references/ per category are needed.
Related
- before: user natural language utterance → this skill automatically invoked
- after: moai-seller:commerce-detail-page-copy → commerce-product-detail → moai-seller:commerce-detail-page-image sequential chaining
- alternative: quick single copy only → moai-seller:commerce-detail-page-copy directly
- Guide:
moai-foundation-cc(Claude Code skill authoring),.claude/rules/moai/development/skill-authoring.md
Korean copy quality gate (required)
Korean text produced by this skill passes a mandatory gate before distribution:
moai-coworker:ai-slop-reviewer— First-pass general AI slop review (banned words, structural patterns, rhythm)moai-writer:korean-humanize— Second-pass precise Korean editing (40+ pattern SSOT, meaning-invariant)
The two gates catch em-dash-contrast headlines, particles, noun-ending fragments, and the "from A to B" transition formula S1 pattern. Outputs are not distributed directly without passing the gate.