← Back to Skills Marketplace
353
Downloads
0
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install skill-dropshipping-fulfillment
Description
Automates order fulfillment by pushing WooCommerce orders to CJ Dropshipping. Fetches "Processing" orders, matches line items to CJ variants via a supplier s...
Usage Guidance
This package implements the dropshipping workflow but has several red flags you should address before running it on real data:
- Credentials and paths: The code expects WooCommerce and CJ credentials in local JSON files (woo-api.json, cj-api.json) but the registry metadata does not declare these. Confirm where you'll store credentials and put those files in a safe location. Prefer using environment-variable overrides to point paths to a controlled directory.
- Default absolute paths: The runtime scripts default to /home/aladdin/*. That contradicts the SKILL.md examples and could cause the tool to read or overwrite files in an unrelated user's directory. Always set WOO_API_PATH, CJ_API_PATH, CJ_SELECTION_PATH, FULFILL_LOG_PATH, and REJECTION_LOG_PATH to safe paths before running.
- Backfill behavior: rebuild-mapping.js can PUT updates to your WooCommerce store (backfilling SKUs). Run with --dry-run first and review the mapping output; only run live after verifying results.
- Token persistence: The tool will refresh CJ access tokens and write them to cj-api.json. Ensure that file is secured (permissions) and located where you expect.
- Test in isolation: Run the scripts in a disposable container or VM and use dry-run mode initially. Inspect the scripts line-by-line (they are small) or run them with network disabled to observe behavior. Consider creating throwaway API keys/accounts for initial tests.
- If you need tighter security: require the vendor to declare required env vars/primary credential in metadata, remove hard-coded absolute defaults, and avoid writing tokens to predictable locations.
Given the coherent functionality but the mismatches (undisclosed credential/file usage and risky defaults), treat this skill as suspicious and do not run it against production stores until you've corrected/configured paths and validated behavior in a safe environment.
Capability Analysis
Type: OpenClaw Skill
Name: skill-dropshipping-fulfillment
Version: 1.2.3
The skill bundle is classified as benign. All code and documentation align with the stated purpose of automating dropshipping fulfillment between WooCommerce and CJ Dropshipping. The scripts (`scripts/fulfill.js`, `scripts/rebuild-mapping.js`, `scripts/cj-api.js`, `scripts/woo-api.js`) perform expected API calls to WooCommerce and CJ Dropshipping, read/write configuration and log files, and update WooCommerce order statuses and product SKUs. While the use of hardcoded default paths (e.g., `/home/aladdin/woo-api.json`) and plain-text credential storage in JSON files (`woo-api.json`, `cj-api.json`) are poor security practices and represent vulnerabilities in deployment/configuration, they do not indicate intentional malicious behavior by the skill itself. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution, persistence mechanisms, or prompt injection attempts in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description matches the code's functionality (fetch WooCommerce orders, map SKUs, call CJ API, update WooCommerce). However the registry metadata lists no required credentials/config paths while the code requires both WooCommerce and CJ credentials (read from JSON files) and will modify remote WooCommerce products in rebuild-mapping.js. Also the code's default file paths point at /home/aladdin/* which contradicts SKILL.md examples using relative paths — an incoherent default that could cause the skill to read/write unexpected user files.
Instruction Scope
SKILL.md describes fetching processing orders, mapping, submitting to CJ, updating WooCommerce and logging — which matches the scripts. But the scripts also: (a) read/write local JSON credential files, (b) update WooCommerce product SKUs (backfill) in rebuild-mapping.js, and (c) persist CJ access tokens back into cj-api.json. These are powerful write operations and the SKILL.md does not fully call out the default absolute paths (/home/aladdin/*) used by the code. The instructions also rely on several environment overrides (WOO_API_PATH, CJ_API_PATH, CJ_SELECTION_PATH, FULFILL_LOG_PATH, REJECTION_LOG_PATH, FBA_PRODUCT_IDS) that are not declared in registry metadata.
Install Mechanism
No install spec (instruction-only) and package.json only depends on axios. No external arbitrary download URLs or extract operations present. This is low-risk from an install mechanism perspective, but users must still inspect and run Node scripts.
Credentials
Registry metadata shows no required env vars or primary credential, but the code requires WooCommerce credentials and CJ API keys stored in local JSON files (woo-api.json, cj-api.json) and uses environment variables to override file paths and FBA_PRODUCT_IDS. The omission of these required credentials from metadata is a mismatch and raises risk: the skill will access local files for secrets (and will write CJ tokens back to disk).
Persistence & Privilege
always:false and the skill does not modify other skills or system configuration. It does persist data: writes logs (cj-fulfillment-log.json, cj-rejection-log.json), updates/creates cj-supplier-selection.json and updates cj-api.json with refreshed tokens, and rebuild-mapping.js can call WooCommerce PUT endpoints to backfill SKUs. Those are within its functional scope but are write-capable operations that merit caution.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill-dropshipping-fulfillment - After installation, invoke the skill by name or use
/skill-dropshipping-fulfillment - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.3
Version 1.2.3 of skill-dropshipping-fulfillment
- No files were changed in this version.
- Documentation and feature descriptions remain unchanged from the previous release.
v1.2.2
- Improved code in fulfill.js and rebuild-mapping.js for better maintainability.
- No changes to user-facing behavior or skill usage.
v1.2.1
- Expanded supplier selection mapping to a full 6-field schema with SKU-first matching and fallback to WooCommerce product/variation IDs.
- Added instructions and support for automatic mapping file generation via `rebuild-mapping.js`.
- Introduced FBA/excluded product support through the `FBA_PRODUCT_IDS` environment variable—marked products are skipped and logged.
- Enhanced logging: unmatched/skipped items are now tracked in `cj-rejection-log.json` for manual review.
v1.2.0
- Added missing dependencies and updated versions in package.json and package-lock.json for improved compatibility.
- Refactored scripts for order fulfillment and API interaction to enhance code readability and maintainability.
- Improved logging and error handling across the main scripts.
- Updated internal mapping and WooCommerce API logic for more robust order processing.
v1.1.0
- Adds full support for automated WooCommerce order fulfillment via CJ Dropshipping.
- Fetches "processing" WooCommerce orders and matches items to CJ variants using a supplier map.
- Submits matched orders to CJ API, updates WooCommerce statuses, and logs results.
- Supports dry-run mode and processing a single order.
- Easily configurable through environment variables and JSON mapping files.
Metadata
Frequently Asked Questions
What is Skill Dropshipping Fulfillment?
Automates order fulfillment by pushing WooCommerce orders to CJ Dropshipping. Fetches "Processing" orders, matches line items to CJ variants via a supplier s... It is an AI Agent Skill for Claude Code / OpenClaw, with 353 downloads so far.
How do I install Skill Dropshipping Fulfillment?
Run "/install skill-dropshipping-fulfillment" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill Dropshipping Fulfillment free?
Yes, Skill Dropshipping Fulfillment is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Skill Dropshipping Fulfillment support?
Skill Dropshipping Fulfillment is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill Dropshipping Fulfillment?
It is built and maintained by Zero2Ai (@zero2ai-hub); the current version is v1.2.3.
More Skills