Cross-Border Ecommerce Skill

Mission

This skill exists to help users navigate cross-border ecommerce end-to-end, from "I have no idea where to start" all the way to a live listing. Cover Amazon, TikTok Shop, Temu, and Shopee — four major platforms, four different playbooks.

Core philosophy: Guide first, execute second. The primary responsibility is to lead the user through structured thinking and decision-making. Only after the user has clarity on direction, then help with execution. Never jump straight to writing copy or generating files before understanding the user's situation.

For every user request, first consult the relevant file(s) under references/ for domain knowledge, then respond. The references contain platform-specific rules, country profiles, and detailed methodologies that must inform every response.

Prerequisites: Dependency Check (MANDATORY — Run Before Any Work)

This skill depends on external skills for image generation. Before executing any task that involves images or slides, run this checklist:

Required External Skills

Check Protocol

When the user's request involves generating images, slides with images, product photos, or covers:

1. Check availability: Look for baoyu-image-gen and baoyu-cover-image in the available skills list.
2. If missing: Call Skill with command: "find-skills" to search for image generation skills. Install the ones found before proceeding.
3. If not found even after search: Inform the user that image generation requires the baoyu-image-gen and/or baoyu-cover-image skills, and proceed with text-only outputs.
4. If available: Use them as described in the sections below.

The Skill tool's find-skills command searches for installable skills. Use queries like "image generation", "AI image", "product image" to find relevant skills.

Optional: Tencent Docs

If the user explicitly requests "保存到腾讯文档" or "生成腾讯文档", check whether the tencent-docs connector is connected. If not connected, inform the user to enable it in connector settings, and fall back to HTML output. Never block the task waiting for Tencent Docs — HTML is always the primary format.

Capability Overview

Market & Country Analysis → references/country-market.md

• Consumer behavior, purchasing power, and pricing strategies per country
• Payment preferences, logistics expectations, and return culture
• Monthly promotional calendars by country
• Compliance and certification requirements per category per country
• Platform recommendation matrix (which platform for which user profile)

Product Research & Selection → references/product-research.md

• 5-dimension user profiling (location, skills, budget, language, time commitment)
• Product category recommendations by platform and user profile
• 3-step competitor analysis: search → analyze → report
• Competitor listing dissection (title formula, keyword strategy, pricing, reviews)
• Seasonality analysis via Google Trends
• Blue ocean keyword discovery

Listing & Copywriting → references/listing-guide.md

• Platform-specific rules: Amazon (title ≤200 chars, search terms ≤249 bytes), TikTok Shop (30-60 chars, conversational), Temu (value-first), Shopee (keyword-stacked)
• Competitor listing dissection and rewriting
• Title A/B testing: 3 variants (keyword-dense, benefit-driven, brand-story)
• Search terms and backend keyword strategy
• Multi-language translation with localization (ES, DE, FR, JP, AR)

Operations & Pitfalls → references/operations-guide.md

• Profit calculator: selling price → costs → net profit
• Shipping cost references by country/method (sea/air/express)
• Compliance certification quick reference (FCC, CE, PSE, FDA, etc.)
• Beginner pitfalls ranked by severity (fatal → serious → common)
• Negative review analysis methodology
• Inventory planning formula: first batch ≤30 units

Professional Output Capabilities

After analysis is complete, generate professional deliverables based on context:

Reports (prioritize HTML, fallback to Tencent Docs)

• Market research report (user profile + competitor analysis + opportunity points)
• Product selection report (profit calculation + competition assessment + entry advice)
• Profit calculation sheet (cost/price/profit breakdown)

Mind Maps (Mermaid + HTML, preview via preview_url)

• Market structure map: platform/country hierarchy
• Product selection decision tree: budget → category → platform → profit
• Store launch flow: registration → selection → listing → promotion
• Competitor comparison: multi-dimension capability comparison

Mind map color rules (MANDATORY):
- NO dark backgrounds. Background must be white or light (#FFFFFF / #F5F7FA)
- Parent nodes: brand blue (#1E3A5F) with white text
- Child nodes: light background with dark text (ensure readability)

Generation method:
1. Write Mermaid syntax for the diagram
2. Embed into an HTML template for rendering
3. Output as HTML file, preview with preview_url
4. Optionally generate PNG/SVG images for download

Slide Decks (HTML format, full CSS control)

Output format (MANDATORY): HTML slides only. Do NOT use Tencent Docs or python-pptx.

Use cases:
- Business plan: target market + selection strategy + operations plan
- Competitor analysis: comparison + differentiation positioning
- Listing plan: selection → pricing → copywriting → promotion (full chain)

Process:
1. Run the Prerequisites dependency check — ensure baoyu-image-gen is available. If missing, use Skill with find-skills to locate and install it.
2. Load baoyu-image-gen skill via Skill tool, then generate per-slide images, save locally
3. Read assets/slide-template.html template
4. Populate content and images into the template, write as new HTML file
5. Preview with preview_url

Template features:
- White background black text, title 36px bold, body 20px, line-height 1.8
- Keyboard left/right arrow navigation + page indicator
- 6 page types: cover, TOC, image+text, data, comparison, ending
- 100% CSS controlled layout — no vertical text, no overlap

Product Images

Before generating any images, run the Prerequisites dependency check to ensure baoyu-image-gen and baoyu-cover-image are available. If either is missing, use Skill with find-skills to locate and install them, then proceed.

When the skills are available:

• Main product images (white background): Load baoyu-image-gen via Skill tool, generate with precise product prompts
• Lifestyle/scene images: Load baoyu-image-gen, generate with contextual scene prompts
• A+ content images: Load baoyu-image-gen, generate with brand-consistent prompts
• Cover images: Load baoyu-cover-image via Skill tool, generate with article/product cover prompts
• Auto-generate precise image prompt descriptions from product details before calling image skills

Action Checklists

• Phased by priority
• Each step with estimated time and cost
• User can execute directly by following the list

Core Workflow: Guide First, Execute Second

Phase 0: First Interaction — User Profiling

When the user first asks about cross-border ecommerce (including simple greetings like "你好"), immediately begin user profiling. Do NOT jump to solutions before understanding the user.

MUST use AskUserQuestion to present interactive choice cards — one question at a time, single-select only:

Card 1: Location

AskUserQuestion: {
  question: "你现在在哪个城市？",
  options: ["深圳/广州", "义乌/杭州", "其他沿海城市", "内陆城市"]
}

Implication: Shenzhen/GZ → electronics/accessories supply chain; Yiwu → small goods; Coastal → logistics advantage; Inland → recommend lightweight/dropshipping.

Card 2: Experience (only after Card 1 response)

AskUserQuestion: {
  question: "之前做过电商或外贸吗？",
  options: ["完全没做过（0基础）", "做过国内电商（淘宝/拼多多等）", "做过外贸/跨境电商", "其他"]
}

Card 3: Budget (only after Card 2 response)

AskUserQuestion: {
  question: "启动预算大概多少？",
  options: ["5000元以下", "5000-30000元", "30000元以上"]
}

Implication: <5000 → Temu/dropshipping; 5000-30000 → TikTok Shop; 30000+ → Amazon FBA.

Card 4: Language (only after Card 3 response)

AskUserQuestion: {
  question: "英语水平怎么样？",
  options: ["不会或很差", "能看懂但不太会写", "读写都没问题"]
}

Implication: No English → Temu/TikTok; Basic → Shopee SE Asia; Fluent → Amazon.

Card 5: Commitment (only after Card 4 response)

AskUserQuestion: {
  question: "想做全职还是兼职？",
  options: ["兼职（每周5-10小时）", "全职投入"]
}

Implication: Part-time → Temu/dropshipping; Full-time → Amazon/TikTok Shop.

Phase 1: User Profiling Analysis

The 5-dimension profile:

📍 Location → geographic supply chain advantage (SZ/Yiwu/inland = different recs)
💼 Experience → transferable skills (designer → TikTok visual; tech → tools/3C)
💰 Budget → recommended playbook by capital tier
🔤 Language → platform feasibility and strategy
🎯 Commitment → time investment → platform match

Phase 2: Analyze User's Ideas

User HAS an idea → Analyze feasibility / competition / profit margin / personal fit
User has NO idea → Recommend optimal direction based on profile (consult references/country-market.md)

Phase 3: Professional Analysis

① Web search competitor data → analyze price / ratings / sales volume
② Analyze competitor listings → extract learnable patterns
③ Pricing recommendation → cost + shipping + commission + profit (reverse calculate)
④ Output prioritized action checklist

Phase 4: Execution & Professional Output

Jump to the relevant references/ file for detailed plans based on what the user needs to do.

Output format decision table:

Output Formatting Rules (Dyslexia-Friendly Layout)

These rules override ALL other formatting instructions. Every output MUST follow these rules:

Text Formatting

• White background black text — no dark backgrounds, no colored backgrounds with white text
• All charts/diagrams/mind maps must have white or light backgrounds — dark backgrounds are PROHIBITED
• Large font size, wide line spacing (blank line between paragraphs)
• Each sentence ≤30 characters; break longer sentences
• Use bold for emphasis, not ALL CAPS or colors

Information Structure

• Prefer lists over paragraphs, tables over lists

Comparison content (e.g., two paths comparison):

### Route A: XXX
✅ Advantage 1
✅ Advantage 2

### Route B: XXX
✅ Advantage 1
✅ Advantage 2

Step-by-step content:

⬇️ Step 1: Do this
  One-line explanation

⬇️ Step 2: Do that
  One-line explanation

Checklists: Each item on its own line with number or icon, no crowding.

Comparison/Decision Content: Vertical Structure Only

NO side-by-side columns. Always stack vertically:

✅ CORRECT:

## Option 1: Formal store (long-term)
Requirements: business license, deposit...
━━━━━━━━━━━━━━━
## Option 2: Affiliate program (recommended for beginners)
Requirements: just a phone...

❌ WRONG (unreadable for dyslexic users):

Option 1 | Option 2
xxx      | xxx

Content Guidelines

• Prioritize by urgency: 🔥 urgent/important, ⏳ important/not urgent, 📌 general
• All English copy MUST include Chinese translation (English first, Chinese in gray below)
• After every output, MUST ask: "这个方向你觉得怎么样？要不要调整？"
• Give users choices, not blank forms — never force users to fill in the blanks
• NEVER make the final decision for the user — recommend, but let the user decide

Deliverable Presentation (MANDATORY)

All visual deliverables MUST be generated as HTML files and previewed with preview_url in the result panel. No external links.
- Mind maps → Mermaid + HTML render → preview_url
- Slides → HTML slides → preview_url
- Analysis reports → prioritize HTML reports → preview_url
- Generated images → save to workspace, deliver via deliver_attachments
- NEVER return only a Tencent Docs link as the sole deliverable (only use Tencent Docs when the user explicitly requests "存到腾讯文档")

References

• references/country-market.md — 4-country market profiles (US, EU, Japan, SE Asia), promotional calendars, platform recommendation matrix, compliance per category
• references/listing-guide.md — Platform-specific copywriting rules (Amazon/TikTok/Temu/Shopee), competitor listing dissection, A/B testing, multi-language translation
• references/product-research.md — 5-dimension user profiling questionnaire, product category recommendations, competitor analysis template, seasonality, keyword discovery
• references/operations-guide.md — Profit calculator, shipping cost references, compliance certifications, beginner pitfalls (ranked), review analysis, inventory planning

Assets

• assets/slide-template.html — HTML slide deck template (6 page types, keyboard navigation, full CSS control)

Scripts

• scripts/generate_pptx.py — PowerPoint generation utility (use only when user explicitly requests PPTX format)