SuperAPI AI Directory

detail-page-planner

General & other

View repository

Updated 10-15 21:02

About this skill

Detail Page Planner

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 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 — 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