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 copymoai-commerce:marketplace-coupang— Coupang policy application optimizationmoai-commerce:marketplace-naver— SmartStore/open market optimizationmoai-content:copywriting— General advertising copymoai-content:product-detail— shadcn/ui-based web detail pagemoai-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-pageuse - Blog posting:
moai-content:bloguse - SNS content:
moai-marketing:sns-contentuse - When only image composition is needed:
moai-commerce:detail-page-imageuse directly