Inventory Manager

E-commerce inventory management for Taobao, Douyin, and other platforms. Use when tracking stock levels, syncing inventory across stores, managing suppliers,...

Security Scan

The skill appears to be a demo/local inventory tool but its documentation and instructions claim external API integrations while the shipped code is local/sample-only and the SKILL.md references scripts that don't exist — this mismatch is suspicious and should be clarified before trusting it with real store credentials.

Purpose & Capability

The description promises integration with Taobao and Douyin (real-time API, webhooks, sync), but the provided code contains only simulated sample data and no network/API calls; no credentials or API env vars are requested. A legitimate integrator would typically require API keys/credentials and network access—their absence is disproportionate to the claimed capability.

Instruction Scope

SKILL.md instructs running multiple scripts (e.g., scripts/check_stock.py, scripts/sync_inventory.py, scripts/stock_alerts.py, generate_po.py, forecast_sales.py) that are not present. The actual code is a single script at scripts/inventory_manager.py which supports actions via --action. The docs are therefore misleading/ inconsistent and give the agent broad, unclear instructions (run these scripts) that don't match the code.

Install Mechanism

There is no install specification (instruction-only with a small Python script). Nothing is downloaded or written by an installer, so installation risk is low.

Credentials

The skill declares no required environment variables or credentials, yet SKILL.md and README discuss API credentials, webhooks, and sending email/WeChat alerts. This omission could mean the skill is a local demo (harmless) or that required secrets are expected to be provided ad hoc later (risky).

Persistence & Privilege

The skill is not marked always:true and contains no install-time hooks or requests to modify other skills or agent-wide settings. It does not request persistent privileges.

What to consider before installing

This package looks like a local/demo inventory tool rather than a finished Taobao/Douyin integrator. Before installing or running it with real stores: 1) Do not supply real API keys or credentials until the author explains how they are used and where they are stored. 2) Note that SKILL.md references many scripts that aren't included — the real entrypoint is scripts/inventory_manager.py which currently uses simulated data and makes no network calls. 3) If you plan to use this in production, request (or inspect) updated code that implements secure API calls, explicit env var names for credentials, and safe handling of tokens. 4) Run the code in a sandboxed environment and monitor network traffic to confirm it does only what you expect. 5) If the author cannot clarify the mismatches (missing scripts, missing credential handling, and claimed features), treat this as untrusted for production use.

Overview

Professional inventory management skill for e-commerce sellers. Track stock levels, sync across multiple stores (Taobao, Douyin), manage suppliers, and automate reordering.

Features

• Multi-store inventory sync
• Stock level tracking
• Low stock alerts
• Supplier management
• Sales forecasting
• Purchase order generation
• Barcode/QR code support

Quick Start

Check Stock Levels

python scripts/check_stock.py \
  --stores taobao,douyin \
  --output stock_report.csv

Sync Inventory

python scripts/sync_inventory.py \
  --source taobao \
  --target douyin \
  --sync-all

Set Low Stock Alerts

python scripts/stock_alerts.py \
  --threshold 10 \
  --notify email,wechat

Scripts

check_stock.py

Check current stock levels across stores.

Arguments:

• --stores - Comma-separated store names
• --output - Output file (CSV/Excel)
• --format - Output format

sync_inventory.py

Sync inventory between stores.

Arguments:

• --source - Source store
• --target - Target store(s)
• --sync-all - Sync all products
• --sku - Sync specific SKU

stock_alerts.py

Monitor and alert on low stock.

Arguments:

• --threshold - Low stock threshold
• --notify - Notification channels
• --check-interval - Check frequency (minutes)

generate_po.py

Generate purchase orders for suppliers.

Arguments:

• --supplier - Supplier name
• --items - Items to order
• --output - PO file

Multi-Store Sync

Taobao ↔ Douyin Sync

# Sync from Taobao to Douyin
python scripts/sync_inventory.py \
  --source taobao \
  --target douyin \
  --conflict-resolution source_wins

# Two-way sync
python scripts/sync_inventory.py \
  --source taobao \
  --target douyin \
  --sync-mode bidirectional

Stock Level Rules

• Source wins: Source store quantities override target
• Target wins: Keep existing target quantities
• Max: Use maximum of both
• Min: Use minimum of both (safest)

Low Stock Alerts

Alert Configuration

{
  "alerts": {
    "critical": {"threshold": 5, "action": "immediate_reorder"},
    "low": {"threshold": 10, "action": "send_alert"},
    "medium": {"threshold": 20, "action": "log_only"}
  },
  "notifications": {
    "email": "[e-mail]",
    "wechat": "your_wechat_id"
  }
}

Alert Actions

• Email notification: Send alert email
• WeChat message: Send WeChat notification
• Auto reorder: Generate purchase order
• Pause listing: Hide product from store

Supplier Management

Supplier Database

supplier_id,name,contact,email,lead_time_days,min_order
SUP001,Factory A,John, [e-mail],7,100
SUP002,Factory B,Jane, [e-mail],14,50

Purchase Order Generation

python scripts/generate_po.py \
  --supplier SUP001 \
  --items "SKU001:50,SKU002:100" \
  --output po_20260307.xlsx

Sales Forecasting

Forecast Next Month

python scripts/forecast_sales.py \
  --history sales_history.csv \
  --months 1 \
  --output forecast.csv

Forecast Methods

• Moving average: Simple average of recent sales
• Weighted average: Recent sales weighted higher
• Trend analysis: Linear regression on historical data
• Seasonal: Account for seasonal patterns

Reports

Daily Stock Report

• Current stock levels
• Today's sales
• Stock changes
• Alerts triggered

Weekly Summary

• Week-over-week changes
• Top selling products
• Slow moving items
• Reorder recommendations

Monthly Analytics

• Monthly sales trends
• Inventory turnover
• Stock value
• Supplier performance

Best Practices

1. Sync frequently - At least hourly during business hours
2. Set buffer stock - Don't wait until zero to reorder
3. Track lead times - Know how long suppliers take
4. Monitor trends - Adjust stock based on sales patterns
5. Audit regularly - Physical count vs system count

Integration

Taobao Store

• API integration for real-time stock
• Order webhook for automatic deduction
• Product mapping by SKU

Douyin Store

• API integration for stock updates
• Live sales tracking
• Warehouse sync

Troubleshooting

• Sync conflicts: Review conflict resolution settings
• Stock mismatch: Run physical audit
• API errors: Check API credentials and rate limits
• Missing products: Verify SKU mapping