IntermediateOpenClaw Skill

Localization Planner

Create an ecommerce localization plan that covers the buying experience, not just translated text. Tell your assistant which country you want to enter, what you sell and how the store currently operates; this Skill organizes copy, imagery, payments, delivery and launch priorities into a roadmap your team can review and execute.

Views
0
Copies
0
Favorites
0
Editorial Score
83/100
01

What this Skill does

A translated storefront can still leave customers unsure about payment, delivery or whether the product suits them. Localization Planner reviews those parts of the experience together and turns the gaps into a market-entry roadmap.

Use it when a country has already been shortlisted and the next question is how to launch there. The plan can guide content work, local review and coordination with developers and logistics partners. Payment connections and legal sign-off remain implementation tasks; the Skill helps identify and sequence them.

02

What makes it different

01

Approach and advantage

The templates connect language decisions to imagery, payment preferences and fulfillment information. This makes it easier to spot a localized product page whose checkout or delivery promise still assumes the original market.

02

What you can use it for

A staged roadmap and quality checklist help prioritize the launch scope and review it before release. Update country examples and seasonal dates for the actual launch year, then use local reviewers to check the details that need market-specific judgment.

03

Before you install

Inputs to prepare

Target country, audience, product catalog, budget, current stack, logistics, and local review resources.

Agent and runtime

Use a compatible agent that can discover the installed Skill and read its supporting files. Any external service or creative runtime must be configured separately.

Scope to confirm

It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

04

Install and get started

Send this request to the OpenClaw agent that will use the Skill. It installs the named publisher’s release and checks the workspace configuration.

  1. Use the current OpenClaw CLI in the workspace where this Skill should run.
  2. Install the owner-qualified version below; inspect its path and dependencies with the info command.
  3. Start a new agent session and read the installed instructions before configuring its required services.
Install @leooooooow/localization-planner version 1.1.0 in my active OpenClaw workspace. Use the original ClawHub release, not a same-named substitute. First check whether it is already installed; do not force-overwrite local changes. Run: openclaw skills install @leooooooow/localization-planner --version 1.1.0 openclaw skills info localization-planner Read SKILL.md and all setup references, identify required tools, dependencies and credentials, and report the actual version, path and readiness. Start a new session if needed. Do not describe package installation as a successful business-task test.
05

Original Skill.md

This is the unchanged source SKILL.md for the reviewed version. Install the complete package to retain referenced scripts, assets, and instructions. Starter prompts below are EcomAgentTools examples.

---
name: Localization Planner
description: Plan product listing translations, cultural adaptations, and local payment method integrations for new market entry. Use when an ecommerce seller is opening a Shopify, Amazon, or marketplace presence in a new country and needs a market-specific roadmap covering language, imagery, payments, logistics, labeling, and seasonality.
---

# Localization Planner

Expanding an ecommerce business into a new geographic market requires far more than translating product titles and descriptions. Successful market entry demands cultural adaptation of imagery, tone, and messaging, integration of locally preferred payment methods, compliance with regional labeling standards, and alignment with local shopping behaviors and seasonal calendars. This skill produces a comprehensive localization roadmap that covers every dimension of market adaptation, helping sellers avoid costly missteps and accelerate time-to-revenue.

## Quick Reference

| Decision | Strong | Acceptable | Weak |
|---|---|---|---|
| Translation method | Native-speaker copywriter with category experience; on-page review before publishing | Machine translation + native-speaker editor | Raw machine translation published as-is |
| Imagery | Reshot or selected per market (skin tones, settings, seasonal cues) | Existing imagery with local-friendly subset selected | Global imagery used everywhere |
| Pricing | Local-currency display, rounded to local convention (.99 vs ,90 vs whole) | Currency conversion at checkout only | USD-only at checkout |
| Payments | All top-3 local methods (e.g. iDEAL+Klarna+Cards in NL) live before launch | Card-only + one local method | Card-only |
| Sizing & specs | Localized units (cm/in, kg/lb, EU/UK/US sizes) with conversion charts | Conversion notes in description | Original units only |
| Labeling & compliance | Country-specific labels, warnings, and certifications validated before listing | Generic labels with notes appended | No localization of compliance items |
| Calendar | Local promotional calendar (Singles Day, BFCM, regional holidays) baked into Y1 plan | Global calendar + 1-2 regional events | Same plan as home market |
| Launch sequencing | Phase 1 (top 10 SKUs) → Phase 2 (depth) → Phase 3 (expansion), with kill criteria at each phase | Full catalog at once | Listing as-is and seeing what sells |

## Problems this skill solves

1. A DTC brand wants to enter Japan and needs to know which local payment methods (Konbini, JCB, Rakuten Pay) to support and in what order.
2. A seller plans a German launch and needs to understand which sizes, voltages, certifications (CE marking), and packaging-waste reporting requirements apply.
3. A US brand entering France must adapt imagery (cooking scenes, body types, dress) and tone (vouvoiement vs tutoiement) without translating literally.
4. An Amazon seller is opening AU and MX marketplaces simultaneously and needs a launch sequence that doesn't drown the team.
5. A brand entering the UAE needs guidance on language (Arabic and English), prayer-time scheduling, Ramadan calendar, and culturally appropriate imagery.
6. A founder launching in Brazil needs to know about Boleto, PIX, installment culture (parcelado), import duty quirks, and Portuguese vs Brazilian Portuguese.
7. A brand expanding into Korea needs to address Naver-driven search behavior, Kakao Pay, KC certification, and the role of mass-market malls (Coupang, Gmarket).

## Workflow

### Step 1: Define the market entry hypothesis
What is the value proposition in this market, who is the target buyer, and why this market now? Without an answer the localization plan optimizes the wrong things. See `references/market-entry-brief.md`.

### Step 2: Map the local commerce stack
Identify: dominant marketplaces vs DTC, dominant browsers and devices, dominant payment methods (and their share), preferred logistics carriers, common return windows and expectations, and review behavior. See `references/market-stack-reference.md` for a starter table covering 20 markets.

### Step 3: Localize the listing surface
Translate copy with a native-speaker writer who understands the category. Adapt imagery: skin tones, seasonal cues, environments. Localize sizing, units, and any technical specs. Validate compliance items (labels, warnings, certifications) per category and country.

### Step 4: Build the payment stack
Integrate the top 3 local payment methods before launch. Display in local currency with local conventions (decimal separator, rounding, installment options). Test the full checkout in-market.

### Step 5: Align with the local calendar
Pull the next 12 months of local shopping events: holidays, school terms, sales days, weather-driven peaks. Build the promotional plan around them. See `references/holiday-calendar.md` for a starter set.

### Step 6: Sequence the launch
Phase 1: top 10 SKUs with the highest fit. Phase 2: depth across phase-1 categories once unit economics validate. Phase 3: expand to adjacent categories. Define kill criteria for each phase.

### Step 7: Measure and adapt
Track market-specific KPIs: organic vs paid mix, payment-method conversion rate by option, return rate vs home market, review sentiment vs home market, search-term match rate. Re-plan quarterly.

## Worked Example 1: US apparel brand entering Germany

**Inputs:** US DTC apparel brand, $8M ARR, considering DE. Catalog of 120 SKUs. Hero: organic cotton basics.

**Plan:**
- Market entry hypothesis: German shoppers index high on organic certification + transparency. Position on GOTS-certified hero plus transparent supply chain page.
- Stack: Shopify DE store-front. Klarna + PayPal + SEPA + cards. Free returns within 14 days (DE legal min) extended to 30 (brand standard).
- Listing surface: native-German copywriter (not US-trained); imagery reshot for autumn-forward palette; EU sizing with conversion chart; CE not required for apparel but care-label compliant with EU Textile Reg 1007/2011.
- Compliance: VerpackG packaging registration done before first parcel ships.
- Calendar: BFCM is smaller; Singles' Day not yet major; Sinterklaas is a tertiary; Christmas peak runs Nov 15–Dec 22. Spring asparagus / outdoor weeks are non-obvious peaks.
- Launch sequence: 25 SKUs at launch (basics core). Add 60 more in week 12 if conversion rate >1.6% and return rate <8%. Pause if return rate >12%.
- Expected: 6 months to 5% of US channel revenue.

## Worked Example 2: Beauty brand entering Brazil

**Inputs:** US-based clean-beauty brand, mid-tier price point, considering BR. ANVISA registration is the largest unknown.

**Plan:**
- Market entry hypothesis: Brazilian beauty buyers reward formula efficacy and influencer endorsement. Position on results + creator partnerships, not the "clean" marketing that drives US growth.
- Stack: Direct B2C via local 3PL + Amazon BR + Mercado Livre.
- Payments: PIX, Boleto, cards with parcelado (2–6 installments). Without parcelado, AOV drops 30%.
- Listing surface: BR Portuguese (not PT-PT); imagery includes Brazilian skin-tone range as primary, not afterthought.
- Compliance: ANVISA registration per SKU (4–8 months). Phase 1 = only registered SKUs; don't list ahead of registration.
- Calendar: Black Friday is huge in BR; Mother's Day (2nd Sunday of May) is bigger than Valentine's; Carnaval week is sales soft for beauty.
- Launch sequence: ANVISA-approved hero SKUs first; expand once second batch clears.
- Expected: longer ramp than DE due to ANVISA; rewards 18-month patience.

## Common Mistakes

1. **Treating localization as translation.** Translation is one tactic. Imagery, payments, sizing, and compliance often matter more.
2. **Using machine translation alone.** Idioms, tone, and category-specific language collapse without a native editor.
3. **Skipping local payment methods.** A buyer who can't pay with their preferred method usually doesn't pay at all.
4. **Carrying over the home-market calendar.** Holidays, school terms, and weather cycles differ; the promo plan must too.
5. **Ignoring sizing and unit norms.** Apparel without EU sizing or appliances without the right plug standard simply won't sell.
6. **Listing the entire catalog at launch.** A focused phase 1 outperforms a broad phase 1 every time.
7. **Underestimating compliance lead time.** ANVISA, KC, CCC, CE evaluations can take months; build them into the plan.
8. **Skipping returns localization.** Some markets mandate longer return windows; ignoring them is a legal risk.
9. **One creator strategy across markets.** Local creators move local audiences; global creators rarely translate.
10. **No exit criteria.** A market without phase-level kill criteria can drain margin quietly for years.

## Resources

- `references/market-entry-brief.md` — Template to capture the entry hypothesis before planning.
- `references/market-stack-reference.md` — Quick-reference table for 20 markets: payments, logistics, search behavior.
- `references/holiday-calendar.md` — Local promotional and cultural calendar starter for top markets.
- `references/output-template.md` — Localization plan template covering all 7 workflow steps.
- `assets/quality-checklist.md` — 45-point checklist to validate the plan before market launch.
06

Get started

Starter prompts for the main use cases—copy and use them directly.

01

Plan a German apparel launch with localized sizing

Plan a German apparel launch with localized sizing Use for: Plan a German apparel launch with localized sizing. Prepare: Target country, audience, product catalog, budget, current stack, logistics, and local review resources.

Show prompt and variablesHide prompt and variables
Use the installed localization-planner Skill. Task: Plan a German apparel launch with localized sizing. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

Replace these variables

[INPUT]
Target country, audience, product catalog, budget, current stack, logistics, and local review resources.
[CONSTRAINTS]
Scope, allowed actions, output format, and review requirements.
02

Sequence payment and language work for a Brazil launch

Sequence payment and language work for a Brazil launch Use for: Sequence payment and language work for a Brazil launch. Prepare: Target country, audience, product catalog, budget, current stack, logistics, and local review resources.

Show prompt and variablesHide prompt and variables
Use the installed localization-planner Skill. Task: Sequence payment and language work for a Brazil launch. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

Replace these variables

[INPUT]
Target country, audience, product catalog, budget, current stack, logistics, and local review resources.
[CONSTRAINTS]
Scope, allowed actions, output format, and review requirements.
03

Build a phased SKU launch and local calendar

Build a phased SKU launch and local calendar Use for: Build a phased SKU launch and local calendar. Prepare: Target country, audience, product catalog, budget, current stack, logistics, and local review resources.

Show prompt and variablesHide prompt and variables
Use the installed localization-planner Skill. Task: Build a phased SKU launch and local calendar. Inputs: [INPUT]. Constraints: [CONSTRAINTS]. Check missing information first. Produce a reviewable result with evidence, assumptions, and next steps. It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

Replace these variables

[INPUT]
Target country, audience, product catalog, budget, current stack, logistics, and local review resources.
[CONSTRAINTS]
Scope, allowed actions, output format, and review requirements.
07

Worked example: Turn a Japan-market idea into a gated launch roadmap

A synthetic merchant explores Japanese-language DTC for one mug with a $3,000 cap. Japanese inquiries, market assumptions and existing US-only service constraints inform a conditional pilot.

Steps and prompt

  1. Prepare the attached business materials, preserving amounts, units, dates and metric definitions.
  2. Build a Japan market-entry plan from our product and market brief. Include a Japanese product-page draft, image directions, payment and delivery requirements, labeling review, a 90-day pilot and a 12-month merchandising calendar. Set budgets, ownership, launch gates and stop conditions using the supplied assumptions.
  3. Submit the exact prompt below. Read the primary deliverable on the right and download all deliverables for the team handoff.

Case input files: business-inputs.zip

Use the localization-planner Skill.

Build a Japan market-entry plan from our product and market brief. Include a Japanese product-page draft, image directions, payment and delivery requirements, labeling review, a 90-day pilot and a 12-month merchandising calendar. Set budgets, ownership, launch gates and stop conditions using the supplied assumptions.

The attached business materials are:
- inputs/brief.json
- inputs/market-evidence.md

Deliver a complete result.md report that the operations team can read, plus any finished files needed for this task. Keep supporting calculations and evidence with the deliverables. Write the report in English; use the requested target language for customer-facing copy. The business datasets are fictional examples unless the brief explicitly names a live public website.

What the run produced

The primary file produced by this prompt is shown below in its original language.

HarborMug: Japan market-entry decision and operating plan

Decision

Prepare a conditional February 2027 DTC pilot for HM-BLUE-001 only, with a maximum of 100 units and USD3,000 (JPY450,000 at the planning exchange rate). Do not ship inventory or accept Japan orders until the launch gates below pass. The 90-day target is 60 paid, fulfilled, single-unit orders and JPY216,000 gross product revenue; this is a learning target, not a market-size estimate or profit forecast. Start the 90-day clock only when the store is ready to sell. If readiness slips, move the launch rather than compress review.

The merchant inputs and market evidence are synthetic. All targets, allocations and operating policies below are proposals; public references inform requirements but do not establish merchant eligibility or completed compliance.

The critical constraint is the missing Japan operating route: international delivery is currently disabled, Yamato is uncontracted, the native reviewer is not hired, and tax, import, fulfillment and return costs are unknown. A small budget may not cover required testing or a local operating partner. If it does not, stop before inventory commitment.

Entry hypothesis and channel

Test whether clear Japanese care information, honest dimensions and a domestic return route make a mid-market stainless steel mug attractive to urban commuters aged 25–44, earning JPY3–6 million annually. The proposed JPY3,600 price matches USD24 only at the assumed USD1 = JPY150; willingness to pay remains unproven. Twelve Japanese-language inquiries in October justify a bounded test, not a demand forecast. Addressable revenue is unknown.

Use a Japanese-language DTC storefront, preferably a localized Shopify surface if the merchant's stack and provider eligibility permit. Google search is the initial acquisition channel. Monitor Rakuten search vocabulary without committing to a marketplace store. Amazon Japan, Rakuten and Yahoo Shopping are discovery candidates from the skill's starter table, not verified channel-share findings. An ordinary ceramic mug is the indirect substitute. The supplied fictional competitors suggest three testable differentiators:

Fictional competitorSupplied strengthSupplied gapHarborMug response
KumoCupColorsCare clarityPut hand-wash and microwave warnings beside purchase controls
NamiSteelShipping speedCompact sizesShow actual 9 × 9 × 19 cm dimensions; do not call it compact
AsaBottleMarketplace reviewsSimple photographyUse uncluttered product and cleaning photographs

Do not claim these brands represent observed Japanese competition. The main objection is overseas-return hassle; solve the return route before spending on traffic. Launch mugs only; no apparel or electronics. One SKU is appropriate because only one was supplied; do not invent a ten-SKU assortment.

Commerce, payments and delivery

LayerPilot requirement and owner
DevicesDesign for the supplied assumed 80% mobile mix. Mia checks iPhone Safari and Android Chrome first, then desktop; assumed browser mix is Safari 50%, Chrome 45%, other 5%. Check 320/375/390 px widths, Japanese wrapping, price, warnings, policy links and final-order summary.
Language/supportMia owns Japanese content and support workflow; hire a native Japanese category editor. Proposed staffed service: weekdays 10:00–17:00 JST, first response within one Japan business day; confirm staffing before advertising it. Alex handles exceptions and refunds requiring approval.
PaymentsLaunch with cards including JCB, Konbini and Rakuten Pay. Assumed preference mix is 55% / 30% / 15%, not measured market share. Confirm merchant-country eligibility and all fees before choosing a provider.
DeliveryProposed Japan domestic stock and Yamato fulfillment after import clearance, with tracking and a domestic returns address. No direct US-to-consumer shipping promise while international delivery is disabled.
ReturnsProposed 30 days from delivery for unused goods; buyer pays change-of-mind return freight, merchant pays confirmed defect/wrong-item costs. State refund treatment of original shipping and all exceptions after legal review. Do not apply unused-only rules to override defect rights.
ReviewsRequest honest verified-purchase feedback after delivery; no fabricated endorsements. Code feedback for cleaning, dimensions, delivery and return friction. No star rating until genuine eligible reviews exist.

Payment implementation order: Alex first secures provider eligibility and quotes, then the implementer connects cards/JCB, Konbini and Rakuten Pay. The order is a build sequence; all three remain launch gates. KOMOJU's Shopify documentation lists these options for merchants in Japan, which does not establish eligibility for this US merchant. Shopify's Japan documentation limits JCB to domestic Japanese customers paying in JPY and notes approval can take up to three weeks. Budget four weeks as a planning buffer, not a guaranteed onboarding lead time. Do not assume opening a Japan entity is affordable within this pilot.

Use whole-yen prices. JPY3,600 is the proposed final customer product price; finance must confirm tax-inclusive presentation and net receipts. Do not silently add tax at checkout. Do not auto-convert the US USD5 shipping fee or USD50 free-shipping threshold. Initially use one quoted flat domestic shipping fee, separately disclosed, with no free-shipping offer; publish only after the route is costed. Disable installments unless a separately reviewed provider option is justified.

Before release, test success, decline, cancellation, authentication, duplicated callbacks and refunds for each method in sandbox. For Konbini, reserve stock while payment is pending, display the provider's actual deadline, release expired reservations, and ship only after verified payment. Test delayed confirmation and reconciliation. Record payment attempt, pending, paid, expired, refunded and fulfilled states independently. Rakuten Pay redirects must return correctly on mobile. No test purchases or payment methods were used in preparing this plan. Controlled live success/refund checks by the merchant remain a final release requirement; if unavailable, do not sell.

Delivery requirements: obtain importer and customs broker responsibility, all-in inbound quote, tariff classification and tax treatment; establish clearance before domestic shipment. Confirm the measured packed weight and dimensions: supplied 0.35 kg and 9 × 9 × 19 cm describe the product, not a parcel tariff. Contract storage, pick/pack, damage handling, tracking, failed-delivery handling and domestic return inspection. No duty collection at the consumer's door under the proposed domestic-stock model. The US two-business-day dispatch and three-to-five-business-day delivery assumptions are not Japan promises. As a service target, validate dispatch within two Japan business days after payment and a postcode-specific transit table before publishing. Yamato's delivery FAQ directs customers to route-specific delivery estimates; do not promise universal next-day delivery. Offer time slots only if the contracted service supports them.

Mia logs return requests, sends the domestic return instructions, and arranges inspection; Alex approves refunds. Finance reconciles provider refunds to the original order. Disclose method-specific refund routes and timing once contracted, particularly for cash-based Konbini. The supplied US return example does not establish a Japan policy or require an account action.

Japanese product-page draft

This is a complete editorial draft for the supplied product facts, pending native review. The service block is a prelaunch holding message; replace it with approved price, shipping, payment and returns disclosures before enabling purchase. Blue is suggested by the SKU name but is not a confirmed product attribute, so the draft omits color. Do not describe vacuum construction, leak resistance, cup-holder fit, BPA status, dishwasher safety or temperature retention without evidence.


HarborMug ステンレス製マグ 500mL

毎日の一杯に。サイズも、お手入れ方法も、わかりやすく。

容量500mLのステンレス製マグです。ご購入前に、本体サイズとお手入れ方法をご確認ください。

販売予定価格:3,600円

日本向けの販売開始時期、送料、お届け日数は現在準備中です。

商品仕様

項目内容
容量500mL
素材ステンレス鋼(部品ごとの素材は確認中)
本体サイズ9 × 9 × 19 cm
重量350g
品番HM-BLUE-001

お手入れとご注意

  • 手洗いしてください。
  • 電子レンジでは使用できません。
  • 熱い飲み物によるやけどにご注意ください。

ご購入前によくあるご質問

食器洗い乾燥機は使えますか?
手洗いでお手入れしてください。

大きさはどのくらいですか?
本体サイズは9 × 9 × 19 cm、容量は500mLです。お手持ちのマグや置き場所と比べてご確認ください。

持ち運びの際に横にしても大丈夫ですか?
密閉性や横倒しでの使用については確認できていません。バッグの中での横倒し使用を想定した商品としてはご案内していません。

日本への配送や返品はどうなりますか?
日本向けの配送・返品サービスは準備中です。販売開始前に、送料、お届けの目安、お支払い方法、返品条件をご案内します。

日本向け販売準備中


For the sales-ready version, Mia must replace the holding message and FAQ with confirmed tax-inclusive price, shipping fee and coverage, payment deadline, dispatch and transit estimates, return address/process/cost bearer, refund timing, seller disclosure and support links. Show the same information on the final confirmation screen, with an unambiguous Japanese order button such as 「注文を確定して支払う」 only where it accurately describes the payment flow. Native review must adapt the button for pending Konbini payment. Confirm whether dimensions include a handle and orient width/depth/height before relabeling the measurements. No claim of completed translation review is made.

Image directions and listing adaptation

AssetFinished production directionJapanese overlay / alt-text draftAcceptance check
HeroPhotograph the actual SKU on a light neutral surface, accurate color, full silhouette, no added accessoriesAlt: 「HarborMug 500mL ステンレス製マグの全体写真」Product matches stock; no badges or invented certifications
DimensionsOrthogonal view plus dimension arrows after measuring orientation; show a hand or ruler for scale「本体サイズ 9 × 9 × 19 cm」「容量 500mL」「重量 350g」Numbers match sample; distinguish product from packaging
CareShow actual hand washing without concealing parts or implying soaking is allowed「手洗いしてください」「電子レンジ使用不可」Reviewer checks approved cleaning method and warning legibility
Everyday settingSmall urban desk with actual mug upright; restrained styling, natural lighting「毎日の一杯に」Avoid bag-interior, cycling, sealed-lid or spill-proof implications
Parts/detailShow drinking opening and supplied components only after sample/BOM confirmationAlt: 「マグの飲み口と付属部品」No invented lid, gasket or disassembly directions

Use local Japanese settings where available and inclusive adult models if people appear; do not assume a particular body type or gender represents all buyers. Photograph the product rather than generate evidence of features. Deliver mobile crops and high-resolution originals, keep text out of the source photograph, and use accessible HTML captions. Mia owns a USD150 production ceiling; reduce the shot list to hero, dimensions and care if a quote exceeds it. Native editor signs off on overlays. These are production directions, not completed photo assets.

Labeling and compliance review

Do not equate an insulated steel mug with a certified vacuum bottle. Alex must obtain construction drawings, full food-contact bill of materials (including any plastic, gasket, coating and lid), intended uses, origin, manufacturer details and applicable test records. No certifications are supplied. No certification marks or quantified insulation claims may appear.

Review itemRequired decision/evidenceOwner and planning allowanceCurrent status / release rule
Product classificationDoes construction/use fall under the vacuum-bottle labeling rules?Alex + Japan specialist; 1–2 weeks after documentsUnknown; no sale until classification is recorded
Quality labelIf applicable, confirm prescribed product name, actual capacity, performance testing, component materials, warnings and responsible labeler contactSpecialist + supplier; allow 2–6 weeks including testingMissing; test quote may exceed budget
Food-contact importConfirm Food Sanitation Act route, importer, notification and required testing for all contact materialsImporter/broker + specialist; allow 2–6 weeks after full BOMMissing; clearance required before domestic stock release
Polymer componentsReview applicable positive-list obligations and conformity evidence if plastics are presentSpecialist + supplier, same review windowUnknown; do not assume steel-only exemption for the whole assembly
PackagingReview material identification and packaging/recycling responsibilities for the chosen importer/seller structureAlex + specialist; 1–2 weeksUnknown; determine applicability before printing
Online sale disclosuresSeller identity/contact, total price/fees, payment and delivery timing, cancellation/returns, final confirmation screenLegal reviewer + Mia; 1–2 weeksMissing; approved Japanese disclosures required

Lead times above are scheduling assumptions, not official processing promises. CAA's vacuum-bottle rules apply to defined constructions and uses. If in scope, the rules require specified labeling and performance information, not simply a translated US label. MHLW's import procedure covers commercial imports of food-related products; notification and conformity must be resolved with the responsible importer.

Japanese label working text: 「品番:HM-BLUE-001/容量:500mL/お手入れ:手洗い/電子レンジ使用不可/熱い飲み物によるやけどにご注意ください」. This is a fact-and-warning draft, not a compliant final label. Add the classification-specific name, verified actual capacity in required units (0.5L if confirmed), component materials, required performance values and labeler contact only after review. Obtain safety instructions appropriate to the actual construction. Do not print unresolved fields.

The proposed 30-day unused-return policy needs legal review. CAA's mail-order guidance explains the default eight-day return framework and the role of clearly displayed special return terms; mail order does not have a general cooling-off rule identical to door-to-door sales. Have legal approve both the policy and its placement. A longer marketing window alone does not establish legal adequacy.

Budget and economics

Alex is the decision owner and finance approver. Mia owns support/content. The reviewer, specialist, provider implementer and logistics partner are roles to procure, not staffed resources. No inventory shipment is authorized by this report.

Budget ceilingUSDPlanning JPYRelease condition
Native Japanese category editor30045,000Named reviewer and agreed scope
Labeling/import/legal review and testing allowance50075,000Scoped quote; resolve classification first
Image production15022,500Actual sample and approved shot list
Store/payment setup and QA15022,500Eligible provider and costed platform route
100 units at USD8800120,000Readiness gates pass; authorize purchase separately
Freight/fulfillment allowance at USD4 per unit40060,000All-in route quote; source shipping cost is only a proxy
Paid acquisition30045,000Sales gates pass; release in USD50/100/150 stages
Returns/refund/contingency reserve40060,000Alex releases against documented need
Total3,000450,000Hard commitment ceiling, including fees and taxes

The USD1,100 readiness envelope precedes the USD1,200 stock/route envelope; USD300 media and USD400 reserve remain controlled. Count all platform subscriptions, provider add-ons, testing, brokerage, duties, taxes and extra fulfillment against these envelopes or reserve. No sales receipts automatically replenish spending authority. If quotes cannot fit, stop or request a separately approved revised business case; do not omit a required check. The USD800 stock amount counts even if stock is transferred from existing inventory. Allocate a maximum of 100 units including review samples and replacements; reduce sellable inventory accordingly.

At JPY3,600, known planning costs are JPY1,200 product, JPY600 shipping proxy and JPY138 processing (3% + JPY30), leaving JPY1,662 before taxes, additional logistics, returns and acquisition. Reserving 5% of product receipts (JPY180) leaves JPY1,482. This is an economic refund allowance, not an observed Japan return rate. The contingency cash envelope funds actual refunds and overruns; do not add this accounting reserve twice to the cash budget.

Set a paid CAC target of JPY750 (USD5) and require at least JPY300 contribution after acquisition per order. That leaves only JPY432 per order for additional net tax, import, fulfillment, return-freight and provider/platform costs beyond the shipping proxy. At JPY600 extra costs, contribution after target CAC falls to JPY132 and fails the gate. Finance must rebuild the model with net receipts if the price includes tax; do not assume the full ticket is merchant revenue. Shipping income is conservatively excluded until the fee is settled; include both actual shipping receipts net of fees/tax and actual costs in the final model.

At the 60-order target, gross product revenue is JPY216,000 (USD1,440). The USD300 media cap at target CAC buys at most 60 paid-attributed orders. Fixed readiness spending is not recovered in this scenario: this pilot purchases evidence. No profitability or sales lift is claimed. At JPY300/order after-variable-cost contribution, recovery of USD1,100 readiness spending alone would require 550 orders, beyond the pilot stock ceiling.

Supporting calculations: baseline-calculations.csv, pilot-budget.csv, unit-economics.csv. The sensitivity table treats additional costs as incremental to the USD4 shipping proxy; replace that proxy rather than double-counting a quoted service.

Readiness gates and 90-day pilot

Before February, Mia and Alex should work backward at least 6–8 weeks for content, quotes and compliance. A missed gate moves the target date. Readiness work may use the stated envelope; stock, shipment and selling require Alex's recorded release.

GateRequired evidence and approverFailure action
G0: viable routeAlex confirms eligible seller/importer/provider structure and quotes within USD3,000Stop if entity/partner costs make the cap infeasible
G1: product and consumer complianceSpecialist signs classification, label, safety, import route and online disclosures; native editor signs copyHold inventory and checkout until corrected
G2: economics and deliveryFinance signs actual cost model at ≥JPY300/order after JPY750 CAC; contracted domestic outbound/returns route and SLAReprice and retest willingness to pay, or stop
G3: sales releaseMia records mobile QA, payment/refund checks, paid-order reconciliation, tracking/return rehearsal, support coverage and dashboard; Alex signsRemain in preparation; no paid traffic

No gates are currently passed. Required production payment tests remain for the authorized merchant team; this planning task does not execute them.

PhaseScope and spend releaseSuccess thresholdStop / hold condition
Days 1–30One SKU, DTC; USD50 ads; inspect first 10 fulfilled ordersAt least 10 paid fulfilled orders, no critical checkout issue, ≥95% dispatch within approved SLAPause acquisition at USD50 if fewer than 10 paid-attributed orders; repair before next tranche
Days 31–60Same SKU, USD100 additional ads; improve care/dimension content from actual questionsCumulative ≥30 fulfilled orders; conversion ≥2% after ≥1,000 eligible Japan sessions; paid CAC ≤JPY750Hold further spend if CAC >JPY1,000 after ≥10 paid-attributed orders or USD100 media, whichever first; stop if repair cannot restore cost gate
Days 61–90Same SKU, USD150 final ads; no automatic replenishment≥60 fulfilled orders; contribution ≥JPY300 after acquisition; dispatch ≥95%; unused-return request rate ≤8% on mature ordersNo scale if targets miss; stop replenishment for negative contribution in two weekly reviews or >12% return requests after ≥25 mature deliveries

Safety incident, suspected nonconformity, incorrect charging, or inability to refund triggers an immediate sales pause, regardless of sample size. Mia escalates to Alex the same business day; Alex freezes ads and affected checkout, investigates with the responsible specialist and fulfills customer remedies. Resume only after documented correction and relevant reviewer approval. Budget exhaustion stops new commitments. At day 90, missing the target does not authorize an extension; Alex may approve a separate capped learning test only with a specific fix and budget.

Phase 2, after a successful pilot and a mature returns review, deepens the mug category by at most two supplier-confirmed variants, keeping one channel. Require two consecutive four-week periods meeting cost, service and return gates before adding them. Phase 3 considers an adjacent drinkware category or a marketplace, one change at a time, after another quarter meeting the same gates and new category compliance review. Both phases have USD0 currently authorized; their quotes, working capital and caps must be approved separately. Hold expansion on any failed gate and stop the added variant/channel if its contribution is negative across two reviews or its mature return rate exceeds 12%. Do not expand into apparel or electronics.

Measurement and operating review

MetricSupplied home baselineJapan target / definition
Order conversion2.5% in both weeks≥2% paid completed orders / eligible Japan sessions; report pending Konbini separately
Product AOVUSD24 in both weeksJPY3,600 for a single-unit pilot; reconcile discounts, tax and shipping separately
Refund value / gross5% in both weeksModel allowance 5%; report actual value separately from returned-order rate
Blended ad cost/orderUSD3 in both weeksNot a paid CAC baseline; paid CAC ≤JPY750 using attributed paid customers
Gross ROAS8× in both weeksDiagnostic only; does not measure margin or incrementality
Returned ordersNot supplied≤8% requests / delivered orders with full 30-day eligibility; pause threshold above
Reviews / repeatNot suppliedRequest review from every eligible delivered customer; report response rate and sentiment without a fabricated baseline; repeat purchase diagnostic only
Search-term matchNot supplied≥80% of coded paid clicks relevant to mug/care/size intent after 100 coded clicks
Payment performanceAssumed preference onlyReport paid / initiated by method; ≥90% technical completion for card/wallet attempts excluding valid declines; ≥60% paid-before-expiry for Konbini, assessed after 20 attempts per method

Prior-to-current orders, gross, refunds, spend and sessions each grew 20%; conversion, AOV and refund-value ratio were unchanged. These are home business comparisons, not evidence of Japan growth. Do not infer return incidence from refund dollars.

Before G3, Mia prepares a dashboard with source, device/browser, search term, payment method and state, net receipts, actual variable costs, dispatch, delivery, return eligibility and coded feedback. Report organic and paid sessions/orders separately; attribute paid CAC consistently and report blended acquisition cost alongside it. Investigate a payment funnel >10 percentage points below the other methods after 20 attempts, adjusting for Konbini's payment delay. Do not mistake its pending status for checkout failure.

Mia prepares weekly reviews; Alex approves tranche releases and corrective actions. Reconcile orders and provider settlements weekly. At day 90, orders delivered late in the pilot have not completed the 30-day return window: defer expansion until those cohorts mature. Compare cleaning/dimension complaints and verified-review sentiment with home data only after collecting comparable home data. Replan quarterly, including price, channel, payment mix and economics.

Twelve-month merchandising calendar: February 2027–January 2028

This is the first selling-year calendar, conditional on release. National-holiday dates use the Cabinet Office calendar. Seasonal shopping ideas are merchandising hypotheses, not verified demand peaks. Obon and gifting windows vary; platform sale dates remain unannounced in this plan. Confirm dates and carrier closures before each campaign. Mia prepares creative 6–8 weeks ahead; Alex confirms stock and service capacity four weeks ahead. With one SKU, prioritize practical care and size information over invented seasonal variants.

MonthEvent / merchandising purposeOperational actionPaid-media authority
Feb 2027Conditional debut; holidays Feb 11 and 23Everyday desk imagery; clear care; soft release after gates; publish closure exceptionsUSD50 pilot tranche
MarSpring transition, graduation/new-job gifting hypothesis; equinox Mar 21, substitute holiday Mar 22Size comparison and gift suitability questions; no gift-wrap promise without supplier quoteUSD100 pilot tranche if gates pass
AprNew school/work routines; Showa Day Apr 29Everyday desk use; day-90 review; confirm Golden Week dispatch noticesUSD150 final pilot tranche
MayGolden Week May 3–5; Mother's Day May 9 as optional gifting themeProtect service capacity through holidays; reuse accurate imagery; no unsupported delivery deadlineUSD0 approved beyond pilot
JunRainy-season desk-use hypothesis; Father's Day Jun 20Cleaning guide; test gift messaging only after feedback; do not imply waterproof constructionUSD0; separate phase-2 approval
JulSummer drinks theme; Marine Day Jul 19Show beverage use only within verified instructions; no hours-of-cooling claimsUSD0; replan quarterly
AugMountain Day Aug 11; variable Obon closuresConfirm carrier/warehouse staffing; desk and home imagery rather than spill-proof travel claimsUSD0
SepReturn-to-routine; Respect for the Aged Day Sep 20, equinox Sep 23Readable specification cards; review summer returns; no platform event dates assumedUSD0; new phase budget required
OctCooler-weather desk use; Sports Day Oct 11Refresh warnings for hot drinks; assess adjacent drinkware only after phase gatesUSD0
NovCulture Day Nov 3, Labor Thanksgiving Nov 23; optional Black Friday Nov 26Prepare December stock and cutoff plan; discount only with positive contribution and approved budgetUSD0
DecYear-end / oseibo / Christmas gifting hypothesesLocal reviewer checks appropriateness of single-mug gifting; publish actual delivery cutoffs and closures; no invented endorsementsUSD0
Jan 2028New Year Jan 1; return-to-workConfirm closures and January holiday dates against the 2028 official calendar when available; handle returns; annual decision reviewUSD0

Rakuten sale campaigns are monitoring opportunities only; no participation, dates or incremental spend is assumed. If launch is delayed, preserve this calendar's actual event dates and move the 90-day tranches with the selling start. Avoid a forced holiday launch when the service is unready.

Completion and release status

Completed here: English operating plan, Japanese editorial product-page and label drafts, image directions, phased budget, calculated baseline and cost sensitivities, launch gates, stop rules and first-year calendar. Supporting evidence and release checklist are in evidence-and-release.md.

Release remains blocked by native review, product construction/BOM and compliance evidence, merchant/provider eligibility, actual landed/return costs, domestic fulfillment contract, approved disclosures and checkout tests. These are the gaps that determine whether the USD3,000 pilot is feasible. No sales, shipments, integrations, endorsements or operational improvements have been performed or measured.

Merchant business data is synthetic. Website observations, when present, come from the public URLs listed in the report.

08

Risks and operating notes

Known limits

It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

Evidence and review

Source and package files reviewed: ClawHub 1.1.0. This is a static review, not an installation or business-outcome test.

Before acting on the result

Use authorized inputs and keep secrets out of prompts. Review customer-facing claims, calculations, code changes, and any proposed external action before applying them.

Frequently asked questions

What does it do, and what is the advantage?

Create a market-entry roadmap covering copy, imagery, payments, logistics, and launch sequencing. Market-entry templates and a quality checklist connect adaptation choices to staged launch decisions.

How do I install it and start?

Choose the method for your agent and install the complete package, not just the displayed SKILL.md. Target country, audience, product catalog, budget, current stack, logistics, and local review resources. Start a new agent session and explicitly ask to use localization-planner. Try one use case below with a small sample and review the output.

Which situations is it useful for?

Plan a German apparel launch with localized sizing; Sequence payment and language work for a Brazil launch; Build a phased SKU launch and local calendar

What limitations should I know?

It produces a plan, not payment integrations or legal certification. Country examples and holiday dates must be rechecked for the launch year.

What was checked for this page?

Source and package files reviewed: ClawHub 1.1.0. This is a static review, not an installation or business-outcome test.

No reviews yet.

Leave a review

Rate every dimension, then share your real experience.

Task effectiveness
Setup and ease of use
Reliability and guardrails
Documentation clarity
Time to first useful result
Author / maintainer

LeroyCreates

Source and package files reviewed: ClawHub 1.1.0. This is a static review, not an installation or business-outcome test.