SuperAPI AI Directory

commerce-detail-page-planner

General & other

View repository

Updated 10-15 21:02

About this skill

Detail Page Planner

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 photos
  • references/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:

  1. moai-coworker:ai-slop-reviewer — First-pass general AI slop review (banned words, structural patterns, rhythm)
  2. 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.