A diagnostic and operational toolkit for Shopify store optimization and blog management within the OpenClaw ecosystem.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install icosmos-shop
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install icosmos-shop using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is icosmos-shopify?
icosmos-shopify is a specialized suite of Openclaw Skills designed for comprehensive Shopify store auditing and operational management. It primarily operates in a read-only diagnostic mode, allowing AI agents to identify conversion bottlenecks, analyze product quality, and monitor operational metrics without risking store integrity. By securely pulling store credentials and access tokens from Supabase, it provides a bridge between AI logic and the Shopify Admin, REST, and Storefront APIs.
The tool is built for developers and store operators who need high-fidelity data to drive store improvements. While most commands focus on data extraction and auditing, it includes a robust blog publishing feature to streamline marketing workflows, ensuring that all write operations are guarded by explicit confirmation flags.
icosmos-shopify Use Cases
- Conducting store-wide audits to identify theme and UI/UX issues.
- Diagnosing product listing quality and identifying optimization opportunities.
- Testing the checkout pipeline to detect friction in the customer journey.
- Monitoring business metrics and detecting operational anomalies over specific time windows.
- Automating the distribution of marketing content through Shopify blog publishing.
How icosmos-shopify Works
- The user authenticates by setting environment variables and running the setup command to sync store tokens from Supabase to a local cache.
- The skill interfaces with Shopify APIs to fetch raw data for stores, products, orders, or blog articles.
- Diagnostic modules (audit) process the raw data to identify specific issues like low-quality product descriptions or theme inconsistencies.
- For testing, the skill simulates the checkout flow to verify storefront availability and security.
- When content needs to be updated, the blog module creates new articles using provided HTML files, requiring a mandatory confirmation flag to execute the write operation.
icosmos-shopify Setup
To begin using these Openclaw Skills, you must configure your environment and sync your store credentials:
# 1. Set your Icosmos credentials
export ICOSMOS_USER_EMAIL="[email protected]"
export ICOSMOS_USER_PASSWORD="your_secure_password"
# 2. Sync stores and tokens from Supabase to local cache
./icosmos-shopify setup once
# 3. (Optional) Set a specific Shopify API version
export SHOPIFY_API_VERSION="2026-01"
icosmos-shopify Data Schema & Taxonomy
The skill provides structured JSON output for all data retrieval operations to ensure compatibility with AI processing. The schema includes:
| Field | Description |
|---|---|
store_domain |
The unique .myshopify.com domain of the target store. |
api_version |
The Shopify API version used for the request. |
meta |
Metadata containing pagination info (has_next_page, end_cursor, or REST link headers). |
data |
The core payload containing product, order, or audit details. |
PII Masking |
Sensitive fields like customer emails are automatically nullified or masked in logs. |
icosmos-shopify Advanced Features
- Automatic pagination handling for both GraphQL cursors and REST link-rel headers.
- Mandatory
--confirmflag for write operations to prevent accidental store modifications. - Built-in log desensitization that masks Shopify access tokens (showing only the first and last 4 characters).
- Comprehensive checkout path testing to ensure storefront security and availability.
- Multi-store management via the
--storedomain flag for agencies or power users. - Smart retry logic for handling Shopify's 429 Too Many Requests rate limits.
SKILL.md
Loading
Related Openclaw Skills
icosmos-shopify
A comprehensive Shopify operations and diagnostic skill designed for automated store auditing, performance tracking, and content publishing.
Decker Polymarket
A specialized AI agent skill that enables real-time market searching and automated YES/NO trading on Polymarket via the Decker API.
Decker Hyperliquid DEX Trading
An advanced integration enabling AI-driven perpetual futures trading and market analysis on the Hyperliquid DEX via the Decker platform.
sshot
An automated utility for capturing full-screen Windows screenshots through PowerShell execution within an AI agent environment.
WeChat IP Detection and Publisher
An automated utility for WeChat Official Account creators to verify public IP addresses and trigger article publishing based on network whitelist status.
icosmos-shopify
A comprehensive Shopify diagnostic and operational skill for Openclaw agents to perform store audits, checkout testing, and secure content publishing.
Featured*
