SuperAPI AI Directory

commerce-detail-page-copy

General & other

View repository

Updated 10-15 21:02

About this skill

Detail Page Copy

Overview

This is a specialized skill for generating copy for high-converting e-commerce detail pages. 3 modesare supported:

Mode Flag Description
Default (13 sections) None Generate the full 13-section emotional journey copy (backward compatible with existing)
Diagnose --mode diagnose Current detail page 7-stage diagnostic score
Persona copy --mode copy Generate 2 sets of copy based on JTBD·persona, enforce ratio 25/50/25

Supported categories: electronics / fashion / food / beauty / home / supplement / pet / kids / handmade / general

Trigger keywords

detail page, product detail page, e-commerce detail page, shopping mall copy, product detail, product detail page, product description page, detail page, detail copy, online shopping mall product page, emotional journey copy, 13-section detail page, detail page diagnosis, detail page score, 7-stage diagnosis, persona copy, 2 sets of copy, ratio guide


Extended mode workflow (--mode diagnose / --mode copy)

--mode diagnose: 7-stage diagnostic score

When you input the current detail page URL or a captured image, a diagnostic score is calculated based on the 7-stage criteria.

Input: Current detail page URL or screenshot image

7-stage diagnostic criteria:

Stage Diagnostic item Points
1 Hero — Whether value is conveyed within 10 seconds 15점
2 Pain·Problem — Customer empathy + clarity of problem definition 15점
3 Solution·How — Solution + explanation of how it works 15점
4 Proof·Authority — Social proof + evidence of expertise 15점
5 Benefits — Specificity of benefits + differentiation 10점
6 Risk·Compare·Filter — Risk removal + comparison + target filter 15점
7 CTA — Urgency + clarity of call to action 15점

Output format (--mode diagnose):

{
  "mode": "diagnose",
  "url": "{진단 URL 또는 이미지}",
  "total_score": 67,
  "grade": "B",
  "stages": [
    {"stage": 1, "name": "Hero", "score": 12, "max": 15, "issue": "서브카피 없음", "suggestion": "10초 내 USP 한 줄 추가"},
    {"stage": 2, "name": "Pain·Problem", "score": 8, "max": 15, "issue": "고통점 묘사 추상적", "suggestion": "구체 상황 예시 추가"},
    {"stage": 3, "name": "Solution·How", "score": 13, "max": 15, "issue": "작동 방식 3단계 중 2단계만 있음", "suggestion": "3단계 완성"},
    {"stage": 4, "name": "Proof·Authority", "score": 10, "max": 15, "issue": "리뷰 인용 없음", "suggestion": "실제 구매 리뷰 3개 삽입"},
    {"stage": 5, "name": "Benefits", "score": 7, "max": 10, "issue": "혜택 4개 중 2개 중복", "suggestion": "중복 혜택 제거 후 차별화"},
    {"stage": 6, "name": "Risk·Compare·Filter", "score": 8, "max": 15, "issue": "보증 정책 미표기", "suggestion": "환불 정책 + 비추천 대상 추가"},
    {"stage": 7, "name": "CTA", "score": 9, "max": 15, "issue": "긴급성 요소 없음", "suggestion": "한정 수량 또는 마감일 추가"}
  ],
  "priority_fixes": ["stage4 리뷰 추가", "stage1 서브카피", "stage6 보증 정책"],
  "next_step": "--mode copy 로 개선된 카피 2세트 생성 권장"
}

--mode copy: 2 sets of persona copy (enforce ratio 25/50/25)

Takes JTBD·persona (commerce-jtbd-persona output) and the current detail page as input and generates 2 sets of copy for the main and secondary personas.

Enforce ratio guide (HARD):

  • Problem·Empathy section: 25% (Hero + Pain + Problem)
  • Core·Proof section: 50% (Solution + How + Proof + Authority + Benefits)
  • FAQ·CTA section: 25% (Risk + Compare + Filter + CTA)

Input slots (--mode copy):

Item Required Example
JTBD result Required commerce-jtbd-persona --mode jtbd output
3 personas Required commerce-jtbd-persona --mode persona output
Current detail page Recommended URL or --mode diagnose result (reflecting improvements)

Output format (--mode copy):

{
  "mode": "copy",
  "ratio_guide": "25/50/25",
  "persona_sets": [
    {
      "persona": "메인 (박지연, 32세, 직장인)",
      "jtbd_focus": "F1 — 성분 안전성",
      "sections": {
        "problem_empathy_25pct": {
          "hero": {...},
          "pain": {...},
          "problem": {...}
        },
        "core_proof_50pct": {
          "solution": {...},
          "how": {...},
          "proof": {...},
          "authority": {...},
          "benefits": {...}
        },
        "faq_cta_25pct": {
          "risk": {...},
          "compare": {...},
          "filter": {...},
          "cta": {...}
        }
      }
    },
    {
      "persona": "보조1 (김수현, 27세, 대학원생)",
      "jtbd_focus": "E2 — 클린 라이프스타일",
      "sections": {"...": "..."}
    }
  ],
  "slop_review": {
    "status": "passed",
    "changes_made": 3,
    "notes": "ai-slop-reviewer 검수 완료"
  }
}

ai-slop-reviewer automatic chaining (HARD): --mode copy The output is, after all copy generation, moai-coworker:ai-slop-reviewerautomatically chains.


Existing mode (13 sections, backward compatibility maintained)

When invoked without flags, the existing 13-section emotional journey copy mode runs. The existing workflow, output format, and ai-slop-reviewer chaining all remain the same.


Copy quality guide

Good examples vs examples to avoid (detail page checklist)

✅ Good examples

"하루 종일 피곤하고 집중력이 떨어지시나요?
많은 직장인들이 같은 고민을 하고 있습니다.
100% 자연 성분으로 만든 저희 에너지 드링크는
카페인 부작용 없이 6시간 동안 지속되는 활력을 선사합니다."

→ Concisely includes problem statement + empathy + solution + differentiator. Steps 1, 2, and 3 of the 7-step structure form one flow.Concisely includes problem statement + empathy + solution + differentiator. Steps 1, 2, and 3 of the 7-step structure form one flow.

❌ Examples to avoid

"최고 품질의 에너지 드링크입니다.
맛있고 효과적입니다.
많은 분들이 구매하셨습니다.
빨리 구매하세요."

→ Listing only abstract phrases without concrete proof or differentiators. Fails to clearly perform any of the 7 steps.

PAS copy formula mapping

Mapping between the 7-step structure and the PAS (Problem-Agitate-Solution) copy formula:

7 steps PAS mapping Psychological strategy
1. Problem awareness P (Problem) Accurately describe the problem the target already recognizes in their own language. Do not talk about the product
2. Empathy A (Agitate) Make the problem bigger and more painful. "What happens if you don't solve it now?". Loss aversion bias works
3. Core message Introduce S (Solution) Present the solution. As benefits, not features
4. Proof Reinforce S Finish with social proof. Statistics, reviews, experts
5. Usage/benefits Apply the value equation (what you gain - what you lose) × trust
6. FAQ/handling objections Zero-risk bias e.g., "30-day money-back guarantee"
7. Purchase inducement Loss aversion + anchoring Compared with deadlines, discounts, and price increases

3-step benefit language transformation method

Most copy stops at step 1 (features). Only by reaching step 3 does identity purchase motivation work.

Step Transformation result Example (waterproof material)
Step 1 — Direct result of the feature Product → What can it do Waterproof material → Does not get wet in the rain
Step 2 — Change in the result Result → What changes in daily life Does not get wet in the rain → The worry of carrying an umbrella disappears
Step 3 — Emotion of the change (identity) Change → What kind of person you feel you become The worry disappears → The feeling of becoming a person who goes out lightly even on rainy days

Steal the language from customer reviews: "My back pain is gone" is weaker benefit language than "I no longer grimace when I get up in the morning." The words customers actually used resonate the strongest.

Copywriting Checklist (7-Step Integration)

After generating copy for each step, self-review:

  • Steps 1·2 (25%): Accurately describe the customer's problem in their own language + empathy
  • Steps 3·4·5 (50%): Emphasize differentiators + concrete proof (data, reviews, ingredients) + 3-stage benefit transformation
  • Steps 6·7 (25%): Answer anticipated questions + clear CTA + urgency·anchoring
  • PAS flow check (Problem clear → Agitate strengthen → Solution derive)
  • 3-stage benefit language transformation complete (feature → change → emotion)
  • Avoid prohibited expressions: Abstract phrases such as "highest quality·delicious and effective·buy quickly" ❌
  • Concrete evidence included: 100% natural ingredients, lasts 6 hours, 92% satisfaction, etc. ✅

Required Input Information (Existing Mode)

The orchestrator collects the following information from the user in advance (using AskUserQuestion before invoking the skill):

Item Required or Not Example
Product name Required "Smartwatch X200"
Category Recommended electronics, fashion, food, beauty, home, supplement, pet, kids, handmade, general
Key USP Required "30-hour battery + ANC + IPX5 waterproof"
Target customer Recommended "Office workers in their 20s-40s, those who enjoy exercising"
Price range Optional "129,000 won"
Brand tone Optional "Trustworthy and professional" / "Young and lively"
Sales channel Optional Coupang / Smart Store / Own mall / General purpose
Warranty/AS policy Optional "1-year free A/S"

Workflow

Step 1: Product DNA Analysis

Extract the following from the entered product information:

ProductDNA:
  physical:
    form: 상품 형태
    colors: 대표 색상
    material: 소재
    signature_angle: 대표 각도/뷰
  positioning:
    tier: mass / premium_indie / luxury
    tone: 어조 앵커 (신뢰/흥미/따뜻함/혁신)
    brand_archetype: 브랜드 원형
  palette:
    primary: 대표 색상
    background: 배경 색상

Step 2: Apply Category Brief

Apply visual and copy principles by category (seereferences/category-briefs.md ):

  • electronics: Precise·innovative tone, spec-focused, technical trust
  • fashion: Emotional·lifestyle, use of whitespace, editorial tone
  • food: Warmth·abundance, texture·aroma description, handmade·natural keywords
  • beauty: Radiance·clean beauty, ingredient emphasis, beauty routine connection
  • home: Coziness·intentional living, interior context, emotional lifestyle
  • supplement: Trust·scientific evidence, ingredient clarification, safety assurance
  • general: Clean·general purpose, product-focused, modern minimal

Step 3: Generate 13-Section Copy

references/13-sections.mdWrite copy following the rules for each section of

Copy elements by section

# Section Key elements
1 Hero Main headline (deliver value within 10 seconds) + subcopy + CTA button text + urgency badge
2 Pain Empathy headline + 4 pain points (bullets) + emotional connection copy
3 Problem Twist hook headline + 3 root causes (numbered) + transition copy
4 Story Before state description + turning point label + After state + proof metrics
5 Solution Product name + one-line solution + target fit tagline
6 How How it works in 3 steps (title + short description) + result highlight
7 Proof 3 statistics + 3 reviewer quotes + editorial-tone introduction
8 Authority Founder/expert quote + name + title + credentials
9 Benefits 6 benefits (icon + label) + bonus items + total value statement
10 Risk Guarantee headline + 5 FAQs (Q&A) + official statement
11 Compare 3 Without points vs 3 With points
12 Filter 3 recommended-for targets + 3 not-recommended-for targets
13 CTA Final headline + urgency copy + price/benefit statement + CTA button + closing tagline

Step 4: ai-slop-reviewer automatic chaining (HARD)

Right before producing all text copy, moai-coworker:ai-slop-revieweris called.

Review items:

  • Remove AI-specific repetitive expressions ("Of course", "excellent", "innovative", etc.)
  • Refine excessive adjective clichés
  • Adjust to natural Korean e-commerce phrasing
  • Revise marketing exaggeration into fact-based statements

Output format

Copy JSON structure

{
  "product": {
    "name": "상품명",
    "category": "electronics",
    "usp": "핵심 USP",
    "target": "타겟 고객",
    "price": "가격대",
    "tier": "premium_indie"
  },
  "sections": [
    {
      "id": "hero",
      "label": "Hero (긴급성 헤더)",
      "headline": "메인 헤드라인",
      "subheadline": "서브카피",
      "cta": "CTA 버튼 문구",
      "badge": "긴급성 뱃지 문구"
    },
    {
      "id": "pain",
      "label": "Pain (공감)",
      "headline": "공감 헤드라인",
      "bullets": ["고통점1", "고통점2", "고통점3", "고통점4"],
      "bridge": "감정 연결 문구"
    },
    {
      "id": "problem",
      "label": "Problem (문제 정의)",
      "hook": "반전 훅 헤드라인",
      "causes": ["원인1", "원인2", "원인3"],
      "transition": "전환 문구"
    },
    {
      "id": "story",
      "label": "Story (Before→After)",
      "before": "Before 상태 묘사",
      "turning_point": "전환점 레이블",
      "after": "After 상태 묘사",
      "stat": "증거 수치"
    },
    {
      "id": "solution",
      "label": "Solution (솔루션 소개)",
      "product_name": "상품명",
      "one_liner": "한 줄 솔루션",
      "tagline": "타겟 핏 태그라인"
    },
    {
      "id": "how",
      "label": "How It Works (작동 방식)",
      "steps": [
        {"title": "1단계 제목", "desc": "설명"},
        {"title": "2단계 제목", "desc": "설명"},
        {"title": "3단계 제목", "desc": "설명"}
      ],
      "result": "결과 하이라이트"
    },
    {
      "id": "proof",
      "label": "Social Proof (사회적 증거)",
      "stats": ["통계1", "통계2", "통계3"],
      "reviews": [
        {"quote": "리뷰 인용", "reviewer": "리뷰어명"},
        {"quote": "리뷰 인용", "reviewer": "리뷰어명"},
        {"quote": "리뷰 인용", "reviewer": "리뷰어명"}
      ]
    },
    {
      "id": "authority",
      "label": "Authority (권위/전문성)",
      "quote": "전문가 인용",
      "name": "이름",
      "title": "직함",
      "credentials": "자격/경력"
    },
    {
      "id": "benefits",
      "label": "Benefits (혜택)",
      "items": [
        {"label": "혜택1", "desc": "설명"},
        {"label": "혜택2", "desc": "설명"},
        {"label": "혜택3", "desc": "설명"},
        {"label": "혜택4", "desc": "설명"},
        {"label": "혜택5", "desc": "설명"},
        {"label": "혜택6", "desc": "설명"}
      ],
      "bonus": "보너스 항목",
      "total_value": "총 가치 표현"
    },
    {
      "id": "risk",
      "label": "Risk Removal (리스크 제거)",
      "guarantee_headline": "보증 헤드라인",
      "faqs": [
        {"q": "질문1", "a": "답변1"},
        {"q": "질문2", "a": "답변2"},
        {"q": "질문3", "a": "답변3"},
        {"q": "질문4", "a": "답변4"},
        {"q": "질문5", "a": "답변5"}
      ]
    },
    {
      "id": "compare",
      "label": "Before/After Final (최종 대비)",
      "without": ["포인트1", "포인트2", "포인트3"],
      "with": ["포인트1", "포인트2", "포인트3"]
    },
    {
      "id": "filter",
      "label": "Target Filter (타겟 필터)",
      "recommend": ["추천 대상1", "추천 대상2", "추천 대상3"],
      "not_recommend": ["비추천 대상1", "비추천 대상2", "비추천 대상3"]
    },
    {
      "id": "cta",
      "label": "Final CTA (최종 CTA)",
      "headline": "최종 헤드라인",
      "urgency": "긴급성 카피",
      "price_display": "가격/혜택 표현",
      "cta_button": "CTA 버튼 문구",
      "closing": "마감 태그라인"
    }
  ],
  "slop_review": {
    "status": "passed",
    "changes_made": 0,
    "notes": "ai-slop-reviewer 검수 결과"
  }
}

Markdown preview

After JSON output, provide a markdown preview for user confirmation, section by section.

codex CLI optional backend

codex If the CLI is installed and an OAuth session is active, it can be used as a supplementary aid in the analysis stage. If not installed, Claude generates the copy entirely on its own. In both cases, there is no quality difference.

Check command: codex --version (if absent, run Claude alone)

Usage examples

  • "Write copy for a wireless earbuds detail page — ANC, 30-hour battery, office worker target"
  • "Make a vegan skincare set product page — category beauty"
  • "Handmade wooden cutting board e-commerce detail page — handmade category, premium tone"
  • "Dog probiotics detail page copy — has vet recommendation point"

Quality checklist (extended mode)

--mode diagnose:

  • Score output for all 7 steps
  • At least 1 line of improvement suggestion per step
  • Specify 3 priority revision items

--mode copy:

  • Include all 7 steps (no missing sections)
  • 1 set each for main and secondary personas = 2 sets total
  • Follow the 25/50/25 ratio (problem·empathy / core·proof / FAQ·CTA)
  • ai-slop-reviewer review trace (slop_review block)

Related skills

Chaining: commerce-jtbd-persona --mode persona → commerce-detail-page-copy --mode diagnose → commerce-detail-page-copy --mode copy → commerce-product-naming

  • commerce-jtbd-persona — JTBD·Persona (enter --mode copy)
  • moai-seller:commerce-detail-page-image — Composites a 13-section image based on the generated copy
  • moai-seller:commerce-marketplace-coupang — Coupang policy application optimization
  • moai-seller:commerce-marketplace-naver — SmartStore/open market optimization
  • moai-marketer:content-copywriting — General ad copy
  • moai-seller:commerce-product-detail — shadcn/ui-based web detail page
  • moai-coworker:ai-slop-reviewer — Text review (automatically called in this skill)
  • moai-writer:korean-humanize — Korean AI-ness removal (after slop review, required)

When not to use this skill

  • Landing page (marketing one-pager): moai-marketer:marketing-landing-page use
  • Blog posting: moai-marketer:content-blog use
  • SNS content: moai-marketer:content-sns-content use
  • When only image compositing is needed: moai-seller:commerce-detail-page-image use directly