Agent skill

Ecommerce UX

by mobazha in mobazha/mobazha-unified

E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system.

MPL-2.0Auto-check passedSales & Support

Install Ecommerce UX

skills CLI
$ npx skills add mobazha/mobazha-unified --skill ecommerce-ux -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mobazha/mobazha-unified ecommerce-ux --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/ecommerce-ux .claude/skills/ecommerce-ux && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ecommerce-ux
GitHub stars
165
Token cost
~1.5k tokens
SKILL.md length
204 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
MPL-2.0

At a glance

E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system.

  • Building shopping features
  • SKILL.md covers 一、搜索体验, 二、商品浏览, 三、购物车体验 and 四、结账流程, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve E-commerce operations

What it does

Ecommerce UX is an agent skill from mobazha/mobazha-unified. E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system. Use when building shopping features, checkout flows, or product pages, "电商", "购物", "搜索", "商品", "购物车", "结账", "订单跟踪", "评价".

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering E-commerce operations. The repository describes itself as: Open-source commerce frontend for storefronts, marketplaces, checkout, and seller management. The licence is MPL-2.0.

When your agent uses it

  • Building shopping features
  • Tasks that involve E-commerce operations

Example prompts

  • “/ecommerce-ux”

What it can do on your machine

Read from SKILL.md and the folder at commit 156c699. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ecommerce UX loads about 1.5k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 204 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mobazha/mobazha-unified at commit 156c699, republished under its MPL-2.0 licence (© mobazha). 204 words, ~1,516 tokens.

Download SKILL.mdSave it as .claude/skills/ecommerce-ux/SKILL.md (or your agent's skills folder).
name
ecommerce-ux
description
E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system. Use when building shopping features, checkout flows, or product pages, "电商", "购物", "搜索", "商品", "购物车", "结账", "订单跟踪", "评价".

电商 UX 模式

Mobazha 去中心化市场的核心购物体验规范。

一、搜索体验

搜索输入
tsx
// 即时搜索:输入 debounce 300ms 后自动搜索
<SearchInput
  placeholder={t('search.placeholder')}
  inputMode="search"
  enterKeyHint="search"
  aria-label={t('search.label')}
/>
搜索结果 UX
状态展示
输入中(< 2字符)最近搜索 + 热门搜索
搜索中骨架屏(ProductGridSkeleton)
有结果商品网格 + 结果数量 + 筛选/排序
无结果NoSearchResults 空状态 + 搜索建议
错误LoadError + 重试按钮
筛选面板
  • 移动端:底部 Sheet(FilterSheet,高度 85vh)
  • 桌面端:侧边栏或 Popover
  • 筛选变化后即时刷新结果
  • 显示已激活筛选数量的 badge
排序

常用排序选项:

  • 相关性(默认)
  • 价格 低→高 / 高→低
  • 最新上架
  • 评价最高

二、商品浏览

商品卡片(ProductCard)
元素移动端桌面端
布局2 列网格4-5 列网格
图片1:1 比例1:1 比例
标题最多 2 行截断最多 2 行截断
价格text-primary font-semibold同左
店铺头像隐藏(compact)显示
Hoveractive:scale-[0.98]hover:shadow-lg hover:-translate-y-0.5
商品详情页

图片画廊:

  • 主图大图展示(1:1 或 4:3)
  • 缩略图列表可滚动
  • 移动端:左右滑动切换 + 指示点
  • 桌面端:点击缩略图切换 + 悬停缩放

价格展示:

tsx
// 标准价格
<span className="text-primary text-lg font-semibold">
  {formatPrice(price, currency)}
</span>

// 配对价格(加密货币 + 法币)
<div>
  <span className="text-primary font-semibold">{cryptoPrice}</span>
  <span className="text-muted-foreground text-sm ml-1">({fiatPrice})</span>
</div>

关键操作区:

  • 移动端:固定底栏(ProductBottomBar)包含"加入购物车"和"立即购买"
  • 桌面端:右侧固定区域
变体选择器
tsx
// 颜色/尺寸等变体
<div className="flex flex-wrap gap-2">
  {variants.map(v => (
    <button
      key={v.id}
      className={cn(
        'px-3 py-1.5 rounded-lg border text-sm transition-colors',
        selected === v.id
          ? 'border-primary bg-primary/10 text-primary'
          : 'border-border hover:border-primary/50'
      )}
    >
      {v.label}
    </button>
  ))}
</div>

三、购物车体验

添加到购物车
  • 操作后显示 success toast
  • 底部导航的购物车图标 badge 数字更新
  • 可选:商品飞入购物车的微动画
购物车页面
功能实现
数量调整加减按钮,最小触摸目标 44px
删除商品滑动删除(移动端)或 hover 显示删除按钮(桌面端)
小计实时计算,使用 BigNumber
跨店商品按店铺分组显示
空购物车EmptyCart 空状态 + 去逛逛按钮
价格展示一致性
  • 所有价格使用 useCurrency() hook 格式化
  • 加密货币显示精度:遵循 currencyService 配置
  • 法币配对价格紧跟加密货币价格

四、结账流程

步骤指示器
地址选择 → 支付方式 → 确认订单 → 支付
tsx
<div className="flex items-center justify-between">
  {steps.map((step, i) => (
    <div key={step.id} className="flex items-center">
      <div
        className={cn(
          'w-8 h-8 rounded-full flex items-center justify-center text-sm',
          i <= currentStep ? 'bg-primary text-primary-foreground' : 'bg-muted text-muted-foreground'
        )}
      >
        {i < currentStep ? <Check className="w-4 h-4" /> : i + 1}
      </div>
      {i < steps.length - 1 && (
        <div className={cn('h-0.5 w-8 mx-2', i < currentStep ? 'bg-primary' : 'bg-muted')} />
      )}
    </div>
  ))}
</div>
地址选择
  • 已保存地址列表可快速选择
  • "新增地址"打开 AddressFormModal
  • 默认地址自动预选
支付确认
  • 明确显示总金额(加密货币 + 法币等价)
  • 显示 Escrow 说明(买家保护)
  • 仲裁员信息可查看
  • 移动端:固定底栏显示"确认支付"按钮
错误恢复
错误场景处理
网络断线保留表单数据,提示重试
余额不足显示所需金额,引导充值
钱包未连接引导连接钱包
交易失败显示错误原因 + 重试按钮

五、订单跟踪

状态时间线
tsx
<div className="space-y-4">
  {timeline.map((event, i) => (
    <div key={i} className="flex gap-3">
      <div className="flex flex-col items-center">
        <div className={cn('w-3 h-3 rounded-full', event.completed ? 'bg-primary' : 'bg-muted')} />
        {i < timeline.length - 1 && (
          <div className={cn('w-0.5 flex-1 mt-1', event.completed ? 'bg-primary' : 'bg-muted')} />
        )}
      </div>
      <div className="pb-4">
        <p className="text-sm font-medium">{event.title}</p>
        <p className="text-xs text-muted-foreground">{event.time}</p>
      </div>
    </div>
  ))}
</div>
Escrow 状态可视化
状态图标颜色说明
Funded🔒text-info资金已锁定
Released✅text-success资金已释放给卖家
Refunded↩️text-warning已退款给买家
Disputed⚠️text-destructive争议处理中

六、评价系统

星级评分展示
tsx
// 只读展示
<div className="flex items-center gap-1">
  {[1, 2, 3, 4, 5].map(star => (
    <Star
      key={star}
      className={cn(
        'w-4 h-4',
        star <= rating ? 'fill-amber-500 text-amber-500' : 'text-muted-foreground/30'
      )}
    />
  ))}
  <span className="text-sm text-muted-foreground ml-1">({reviewCount})</span>
</div>
评价列表
  • 按时间倒序(默认)或评分排序
  • 显示买家头像、名称、评分、评论内容、时间
  • 长评论展开/收起

快速检查清单

  • 搜索输入是否有 debounce(300ms)?
  • 空搜索结果是否有引导操作?
  • 商品价格是否使用 useCurrency() 格式化?
  • 购物车数量调整是否有 44px 触摸目标?
  • 结账流程是否有步骤指示?
  • 支付错误是否有明确的恢复路径?
  • 订单状态是否有时间线展示?
  • 移动端关键操作是否在底部固定栏?

相关功能文档

  • 商品模块 — 商品创建/编辑表单设计、5 种商品类型、分类自动补全
  • 配送档案 — Shopify 风格配送架构、运费模板

© mobazha, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/ecommerce-ux of mobazha/mobazha-unified.

Open the folder on GitHubat commit 156c699

Compare with similar skills

Ecommerce UX next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ecommerce UX compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ecommerce UX this skillmobazha/mobazha-unified165—~1.5kAutomated safety check: PassMPL-2.0
Amazon Buy Box Monitorbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Tourmind Bookingtourmind-com/Tourmind-Booking-Skills1.7k—~13kAutomated safety check: PassMIT
Ecommerce Image Suitewzj177/ecommerce-image-suite446—~10kAutomated safety check: PassApache-2.0
Zach Feature Demand Validatorzach22-1999/amazon-skills2081 repos~2.3kAutomated safety check: NotesMIT
Caramel CouponsDevinoSolutions/caramel141—~1.1kAutomated safety check: PassAGPL-3.0

Similar skills

  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Sales & SupportAuto-check passed
  • Tourmind Booking

    tourmind-com/Tourmind-Booking-Skills

    MUST USE for any hotel or accommodation intent in any language, including hotel search, hotel recommendations, nearby accommodation, hostels, guesthouses, resorts, where-to-stay questions, room…

    1.7k GitHub stars~13k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Ecommerce Image Suite

    wzj177/ecommerce-image-suite

    电商套图生成助手。用户明确提出需要生成电商套图、商品主图、卖点图、场景图、模特图等图片内容时触发. An agent skill from wzj177/ecommerce-image-suite.

    446 GitHub stars~10k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Zach Feature Demand Validator

    zach22-1999/amazon-skills

    功能需求真伪验证器。用三维数据(Review/关键词/社区)验证微创新是否真实需求. An agent skill from zach22-1999/amazon-skills.

    208 GitHub starsUsed in 1 repo~2.3k tokens
    Sales & SupportAuto-check: notes
  • Caramel Coupons

    DevinoSolutions/caramel

    Look up live coupon / promo codes for any online store through Caramel's public API (grabcaramel.com) — use whenever the user is about to buy something online, asks for a discount or promo code, or…

    141 GitHub stars~1.1k tokensUpdated today
    Sales & SupportAuto-check passed
  • Zach Sif Cvr Threshold Analyzer

    zach22-1999/amazon-skills

    基于领星 ASIN 360 或同类日业务报表,以及用户自己 SIF MCP 导出的日级关键词自然排名 JSON,回测 CVR 与核心词/稳定词自然排名波动的关系,并输出观察线、危险线、广告 CVR 确认线。

    208 GitHub starsUsed in 1 repo~982 tokens
    Sales & SupportAuto-check: notes

More from mobazha/mobazha-unified

All 29 skills in this repo
  • A11y Guide

    mobazha/mobazha-unified

    Accessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing.

    165 GitHub stars~1.4k tokensUpdated 5 days ago
    Auto-check passed
  • API Reference

    mobazha/mobazha-unified

    Look up Mobazha backend API endpoints, request/response formats, and field mappings.

    165 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Code Review

    mobazha/mobazha-unified

    Review code for quality, architecture consistency, and adherence to Mobazha project standards using confidence-based filtering.

    165 GitHub stars~464 tokensUpdated 5 days ago
    Auto-check passed
  • Code Simplifier

    mobazha/mobazha-unified

    Simplify and refine recently written code for clarity, consistency, and maintainability while preserving all functionality.

    165 GitHub stars~601 tokensUpdated 5 days ago
    Auto-check passed
  • Commit Helper

    mobazha/mobazha-unified

    Generate commit messages and run pre-commit validation following Mobazha conventions.

    165 GitHub stars~735 tokensUpdated 5 days ago
    Auto-check passed
  • Component Dev

    mobazha/mobazha-unified

    Create and modify UI components following Mobazha conventions including directory structure, spacing standards, accessibility, and testing.

    165 GitHub stars~638 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Ecommerce UX

What does Ecommerce UX do?

E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system. Ecommerce UX is an agent skill from mobazha/mobazha-unified. E-commerce UX patterns for Mobazha decentralized marketplace including search experience, product browsing, cart interactions, checkout flow, order tracking, and review system.

When should I use Ecommerce UX?

Ecommerce UX fits situations like: building shopping features; tasks that involve E-commerce operations.

How do I install Ecommerce UX in Claude Code?

Run `npx skills add mobazha/mobazha-unified --skill ecommerce-ux -a claude-code`. Or copy the skill folder (.cursor/skills/ecommerce-ux in mobazha/mobazha-unified) into .claude/skills/ecommerce-ux in your project. Claude Code loads it when a task matches its description.

How do I install Ecommerce UX in Codex?

Run `npx skills add mobazha/mobazha-unified --skill ecommerce-ux -a codex`. Or copy the skill folder (.cursor/skills/ecommerce-ux in mobazha/mobazha-unified) into .agents/skills/ecommerce-ux in your project. Codex loads it when a task matches its description.

Can I use Ecommerce UX in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mobazha/mobazha-unified --skill ecommerce-ux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ecommerce-ux, .gemini/skills/ecommerce-ux, .github/skills/ecommerce-ux and .opencode/skills/ecommerce-ux in your project.

What does Ecommerce UX need to run?

SKILL.md names no scripts, command-line tools or credentials: Ecommerce UX is instructions for the agent only.

Does Ecommerce UX access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ecommerce UX safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ecommerce UX use?

Ecommerce UX is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ecommerce UX use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ecommerce UX?

Skills that share tags, products or a category with Ecommerce UX: Amazon Buy Box Monitor (browser-act/skills, 6.1k stars), Tourmind Booking (tourmind-com/Tourmind-Booking-Skills, 1.7k stars), Ecommerce Image Suite (wzj177/ecommerce-image-suite, 446 stars) and Zach Feature Demand Validator (zach22-1999/amazon-skills, 208 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ecommerce UX?

mobazha (a GitHub organization) maintains it in mobazha/mobazha-unified, which has 165 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 3, 2026.

Source: mobazha/mobazha-unified on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.