Responsibility Boundaries
| Stage | Skill | Deliverables |
|---|---|---|
| 1. Planning & Strategy (★ This Skill) | moai-content:detail-page-planner |
Brief (one message, opening, body skeleton, channel, image checklist) |
| 2. Copy | moai-commerce:detail-page-copy |
13-section emotional journey JSON |
| 3. Code | moai-content:product-detail |
shadcn/ui React or HTML |
| 4. Image | moai-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, listing 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 (atmosphere of each page)
- Separate and operate the two colors
Image selection criteria:
- Photo image: 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 Types Branching ★ Core
UX data basis: 3 seconds = 3 scrolls. On the attention graph, priority goes in the order of "opening > body > closing".
Type Diagnosis Tree
제품이 시장에 처음 나왔는가?
├─ YES → 첫 만남형
└─ NO ↓
제품 자체가 시각적으로 강한가? (예쁨·독특함)
├─ YES → 스타형
└─ NO ↓
타깃의 페인포인트가 명확한가?
├─ YES → 공감형
└─ NO → 매력형 (혜택·가성비 강조)
3-step intro template per type
| Type | Step 1 | Step 2 | Step 3 | Example |
|---|---|---|---|---|
| First Encounter Type | "Have you ever seen a product like this?" | Define the core USP | Value preview | 3 in 1 mouse |
| Star Type | Product visual impact | Emphasize product name and design | Usage scene | Vacuum-packed suit |
| Charm Type | Charm point 1 | Charm point 2 | "The reason you need to decide now" | (benefits, cost-effectiveness) |
| Empathy Type | "You've had this concern, right?" | Pain point concretization | "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 it have a reason to switch customers over?
- Vivid indirect experienceIs this included? (usage scenes, reviews, actual measurements)
Body copy USP organization formula
본문 = 대표 USP 2~3개 + 좋은 제품 특징 2~3개 + 신뢰도/옵션 정보
3-step transformation: "difficult ingredients → expressed from the user's perspective"
[1] 성분 명사 → "히알루론산"
[2] 특징 키워드 → "수분 보유"
[3] 사용자 체감 문장 → "오후 4시에도 촉촉"
Korean advertising review guard (category branching)
- Cosmetics: prohibit pharmaceutical expressions such as regeneration, treatment, cells →
references/category-beauty.md - Food: be careful with definitive efficacy claims →
references/category-food.md - Fashion/lifestyle: be careful with 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 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) | Goal-oriented, immediate judgment | Remove digressions, expose product features immediately, attractiveness/star type first |
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, ingredients, cooking example | Dining table context |
| Beauty | Texture, color payoff, absorption | Usage scenes, before/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 additional 4 types (sports/luxury, etc.), refer to photo-checklist.md.
5 Steps of Detail Page Planning Without Photos (Before Photo Shoot)
[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 Call:
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"
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/star-type first
→ Step 3: One Message — "24-hour moisturizing soap made with 5 plant extracts"
→ Step 4: Opening = empathy-type ("dry skin midwinter itching" → 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 answer, proceed Step 1-7
Example 3 — Receiving Only a Brief and Delegating Follow-up
"이 Brief로 카피랑 코드까지 다 만들어줘"
+ 첨부: 작성된 Brief YAML
→ Step 0: Brief validation (check for missing items in modules 1-5) → After Brief completion: moai-commerce:detail-page-copy → product-detail → moai-commerce:detail-page-image sequential delegation
Relationship with Paired Skills
Cases Where This Skill Is Not Used (Pair Delegation)
- "Make me detail page copy" →
moai-commerce:detail-page-copy(13-section JSON) - "Make me detail page code" →
moai-content:product-detail(shadcn/ui component) - "Composite the detail page image" →
moai-commerce:detail-page-image(1080×12720 PNG) - "Make me a landing page" →
moai-content:landing-page(standalone conversion one-pager)
Cases Where This Skill Is Used
- Above pair call Previous step — when what to make in what structure and what tone must first be decided
- When the category·channel·target are ambiguous, making it hard to go straight to copy·code at once
- 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 steps of 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 — Persona 5 steps + color/font |
| 2 | category-food.md |
Food·Beverages·Agricultural & Marine Products — Purpose/discovery type + food review + 4 storytelling |
| 3 | category-beauty.md |
Skincare·Makeup·Hair·Body — Body 4 steps + Cosmetics Act + ingredient transformation |
| 4 | category-b2b-saas.md |
SaaS·Solutions·B2B Products — Pricing page·feature comparison·demo CTA·multiple decision makers |
| 5 | category-subscription.md |
Subscription Box·Regular Delivery·Membership — LTV·first-order discount·churn prevention |
| 6 | category-baby-kids.md |
Infant·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 |
Other categories (automotive, real estate, finance, medical devices, etc.) recommend a separate domain skill.
Restrictions
- This skill does not directly produce code, copy, or images — Brief output only. Follow-up paired skill invocation required.
- Korean market specialization (Wadiz, Smart Store, Coupang, Kakao specifications). Global markets require a separate guide.
- Ad review guard is based on 2024 — it may change, so regular updates to category-specific references/ are needed.
Related
- before: user natural language utterance → automatic invocation of this skill
- after: moai-commerce:detail-page-copy → product-detail → moai-commerce:detail-page-image sequential chaining
- alternative: quick single copy only → moai-commerce:detail-page-copy directly
- Guide:
moai-foundation-cc(Claude Code skill authoring),.claude/rules/moai/development/skill-authoring.md