ecom

Convert order transaction CSVs into structured ecommerce business reviews.

46|6|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/takechanman1228/claude-ecom --skill ecom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ecom
Source: https://github.com/takechanman1228/claude-ecom/tree/main/skills/ecom
Command: npx skills add https://github.com/takechanman1228/claude-ecom --skill ecom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Turn raw order transaction CSVs into a concise, consultant-style ecommerce business review that highlights momentum, structural health, and prioritized next actions so non-technical store owners and analysts can understand what's driving revenue and what to fix.

Core Features & Use Cases

  • Multi-horizon KPI analysis: Computes 30d, 90d, and 365d KPIs with prior-period comparisons and decompositions.
  • Health checks & KPI trees: Produces pass/watch/fail diagnostics that power 🟢/🟡/🔴 signals in a readable KPI tree.
  • Structured findings & action plan: Outputs a REVIEW.md (or period-specific REVIEW_*.md) with What/Why/What-to-do findings and a prioritized action plan with guardrails.
  • Focused queries: Supports inline answers for natural-language questions (e.g., "how's retention looking?") without generating a full report.
  • Reference-driven interpretation: Loads on-demand narrative templates, cluster logic, and recommended-actions to ground recommendations.

Quick Start

Place your orders CSV in the working directory and run the review command (for example: /ecom review) to produce a REVIEW.md in the output folder.

Frequently Asked Questions about ecom

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an ecommerce business review from order transaction CSVs?

To generate an ecommerce business review, place your order transaction CSV in the working directory and run the review command to output a structured REVIEW.md with KPI decomposition and prioritized action plans.

What is a multi-horizon KPI analysis for ecommerce orders?

Multi-horizon KPI analysis computes 30d, 90d, and 365d ecommerce metrics with prior-period comparisons, decomposing retention and AOV into pass, watch, or fail health checks displayed in a readable KPI tree.

Can I analyze D2C retail order datasets for AOV and retention without a full report?

Yes, you can analyze D2C retail order datasets by asking inline natural-language questions like how retention is looking, receiving focused answers without generating a full REVIEW.md report.

Does the ecommerce review process require a local Python engine?

Yes, the ecommerce review process requires a local Python engine to compute review.json from your orders CSV and generate period-specific reports using on-disk reference files for narrative templates.

What's the best way to diagnose structural health issues in an ecommerce business?

The best way to diagnose structural health issues is running a consultant-grade ecommerce review that produces What, Why, and What-to-do findings with guardrails and a prioritized action plan.

What limitations exist when generating period-specific ecommerce KPI reports?

Period-specific ecommerce KPI reports are limited by the need for a local Python engine and properly formatted order transaction CSVs, requiring on-disk reference files for cluster logic and recommended actions.