SuperAPI AI Directory

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
Basic (13 sections) None Generate the full emotional journey 13-section copy (existing backward compatibility)
Diagnose --mode diagnose Current detail page 7-step diagnostic score
Persona copy --mode copy Generate 2 sets of JTBD·persona-based copy, enforcing a 25/50/25 ratio

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 details, 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-step diagnosis, persona copy, 2 copy sets, ratio guide


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

--mode diagnose: 7-step diagnostic score

If you enter the current detail page URL or a captured image, a diagnostic score is calculated based on the 7-step criteria.

Input: Current detail page URL or screenshot image

7-step diagnostic criteria:

Step 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 — Concreteness 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 persona copy sets (25/50/25 ratio enforced)

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

Ratio guide enforced (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 auto-chaining (HARD): --mode copy Outputs are automatically chained after all copy generation moai-core:ai-slop-revieweris automatically chained.


Legacy mode (13 sections, backward compatible)

When called without flags, the legacy 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시간 동안 지속되는 활력을 선사합니다."

→ Problem statement + empathy + solution + differentiatorconcisely included. Steps 1, 2, 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 value equation (what you gain - what you lose) × trust
6. FAQ/Objection handling Zero risk bias "30-day money-back guarantee", etc.
7. Purchase inducement Loss aversion + anchoring Compared to deadline, discount, price increase

3-step benefit language transformation method

Most copy stops at step 1 (feature). You must go to step 3 for identity purchase motivation to work.

Step Transformation result Example (waterproof material)
Step 1 — Direct result of the feature Product → what can it do Waterproof material → Doesn't get wet in the rain
Step 2 — Change in the result Result → what changes in daily life Doesn't 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 → Feeling like a person who goes out lightly even on rainy days

Steal the language from customer reviews: "My back pain is gone" vs. "I no longer wince when I get up in the morning" is stronger benefit language. The words customers actually used resonate the most.

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)
  • Benefit language 3-stage transformation complete (feature → change → emotion)
  • Avoid prohibited expressions: Abstract phrases like "highest quality·delicious and effective·buy now" ❌
  • Concrete evidence include: 100% natural ingredients, 6-hour lasting, 92% satisfaction, etc. ✅

Required Input Information (Existing Mode)

The orchestrator pre-collects the following information from the user (using AskUserQuestion before skill invocation):

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 energetic"
Sales Channel Optional Coupang / Smart Store / Own Mall / General
Warranty/AS Policy Optional "1-year free A/S"

Workflow

Step 1: Product DNA Analysis

Extract the following from the input 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·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 integration
  • home: Coziness·intentional living, interior context, emotional lifestyle
  • supplement: Trust·scientific evidence, ingredient clarification, safety assurance
  • general: Clean·versatile, product-focused, modern minimal

Step 3: Generate 13-Section Copy

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

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 figures
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 + deadline tagline

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

Right before producing all text copy, moai-core: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 prose style
  • 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 an auxiliary tool 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 points"

Quality checklist (extended mode)

--mode diagnose:

  • Score 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 ratio 25/50/25 (problem·empathy / core·proof / FAQ·CTA)
  • ai-slop-reviewer review trace (slop_review block)

Related skills

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

  • commerce-jtbd-persona — JTBD·Persona (enter with --mode copy)
  • moai-commerce:detail-page-image — Compose a 13-section image based on the generated copy
  • moai-commerce:marketplace-coupang — Coupang policy application optimization
  • moai-commerce:marketplace-naver — SmartStore/open market optimization
  • moai-content:copywriting — General advertising copy
  • moai-content:product-detail — shadcn/ui-based web detail page
  • moai-core:ai-slop-reviewer — Text review (automatically invoked in this skill)

When not to use this skill

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