icosmos-shopify for Openclaw

A comprehensive Shopify diagnostic and operational skill for Openclaw agents to perform store audits, checkout testing, and secure content publishing.

taceywong
v0.0.1
Mar 17, 2026
0
973
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install icosmos

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install icosmos 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 capabilities designed for Openclaw Skills to streamline Shopify store operations and diagnostics. It focuses on read-only auditing to identify issues in store decoration, product listings, and checkout flows, helping developers and store managers pinpoint conversion bottlenecks. By securely fetching store domains and access tokens from Supabase, it provides a robust framework for data-driven store optimization.

While the tool is primarily diagnostic, it includes a strictly controlled write operation for publishing blog content, ensuring that marketing workflows can be automated safely. The skill emphasizes security through log de-identification and PII protection, making it a professional-grade choice for managing complex Shopify environments.

icosmos-shopify Use Cases

  • Performing comprehensive store audits to identify theme and decoration issues.
  • Diagnosing product quality and metadata consistency across large inventories.
  • Testing checkout paths to detect friction points and conversion drops.
  • Monitoring operational metrics and identifying business anomalies over time windows.
  • Automating the publication of marketing articles and SEO-driven blog posts.

How icosmos-shopify Works

  1. Sync store credentials by pulling domain and token data from Supabase into a local cache using user credentials.
  2. Fetch raw data from Shopify using optimized GraphQL or REST API calls for products, orders, or shop details.
  3. Run diagnostic audit modules to evaluate theme performance, product quality, or operational metrics.
  4. Execute simulated checkout tests to verify the Storefront API path and payment availability.
  5. Publish generated blog content to the store, requiring an explicit confirmation flag to prevent accidental updates.

icosmos-shopify Setup

To integrate this with your Openclaw Skills environment, configure your environment variables and initialize the store sync:

# Configure user credentials
export ICOSMOS_USER_EMAIL="[email protected]"
export ICOSMOS_USER_PASSWORD="your_secure_password"

# Optional: Set Shopify API version (defaults to 2026-01)
export SHOPIFY_API_VERSION="2026-01"

# Synchronize store tokens from Supabase
icosmos-shopify setup once

# Verify connection by listing stores
icosmos-shopify stores list

icosmos-shopify Data Schema & Taxonomy

The skill returns structured JSON data optimized for Openclaw Skills processing. It follows a consistent schema for both GraphQL and REST responses:

Attribute Type Description
store_domain String The target myshopify.com domain.
api_version String The Shopify API version used for the request.
meta Object Contains pagination info (has_next_page, end_cursor) and rate limit status.
data Object/Array The primary payload (e.g., product details, order history, or audit results).

Note: Sensitive fields like customer emails are masked or omitted by default to ensure privacy.

icosmos-shopify Advanced Features

  • Multi-store support through centralized credential management via Supabase.
  • Intelligent pagination handling for large-scale data exports (GraphQL cursors and REST Link headers).
  • Built-in dry-run protection for blog publishing to preview content before it goes live.
  • Automated rate-limit handling with retry logic for high-frequency requests (429 status codes).
  • Advanced diagnostic modes for detecting Storefront API security rejections (430 codes).

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*