Shopify Operations

Other Community

Repo stars 0
Author repo FarmFriend-Terminal-React

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: This skill provides comprehensive Shopify store management capabilities through the Shopify Admin GraphQL API. It enables automa…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Overview”, “Core Capabilities”, “1. Product Management”, “2. Theme Configuration”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name Shopify Operations directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Overview / Core Capabilities / 1. Product Management” before expanding.

Boundaries And Review

Dependencies: Prepare Vendor-specific API keys before running a full task.
Permissions: Declared permissions include read / write / shell-exec / env-read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Shopify Operations Skill

Overview

This skill provides comprehensive Shopify store management capabilities through the Shopify Admin GraphQL API. It enables automated product creation, theme configuration, and store initialization.

Core Capabilities

1. Product Management

Create products with variants, pricing, and metadata
Bulk product upload and catalog management
Product image and media attachment
Inventory and pricing management

2. Theme Configuration

Apply JSON-based settings to active themes
Configure colors, typography, and layout
Update theme assets without manual Liquid editing
Theme switching and customization

3. Store Operations

Initialize store settings and policies
Configure shipping zones and tax settings
Set up navigation menus
Manage store metadata and SEO

Prerequisites

Environment Setup

Python 3.7+ with requests and python-dotenv packages
Shopify Admin API access token (starts with shpat_)
Store URL (format: your-shop.myshopify.com)

Required Environment Variables

SHOPIFY_STORE_URL=your-shop.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_your_access_token_here

Installation

pip install requests python-dotenv

Usage Instructions

Product Creation

# Basic product creation
python3 scripts/shop_manager.py create_product \
  --title "Classic T-Shirt" \
  --price "29.99" \
  --vendor "MyBrand" \
  --tags "clothing,cotton" \
  --description "Comfortable 100% organic cotton t-shirt"

Theme Configuration

# Update theme settings
python3 scripts/shop_manager.py update_theme \
  --settings '{"colors": {"button": "#000000", "background": "#ffffff"}}'

Store Information Update

# Update shop settings
python3 scripts/shop_manager.py update_shop \
  --name "My Store" \
  --email "contact@mystore.com" \
  --currency "USD"

Advanced Features

Bulk Operations

For large-scale operations, use the bulk operations API:

Product bulk creation (100+ products)
Inventory updates
Price adjustments

Rate Limiting

The script includes intelligent retry logic:

Automatic backoff on rate limits
Exponential retry with jitter
Request queuing for bulk operations

Error Handling

Comprehensive error reporting
Transaction rollback support
Validation before API calls

Safety and Best Practices

Live Store Warning

⚠️ All operations affect the live store immediately

Always verify SHOPIFY_STORE_URL before execution
Test in development stores first
Use dry-run mode when available

Data Protection

Never commit API tokens to version control
Use environment variables for sensitive data
Implement proper access controls

Backup Recommendations

Export data before bulk operations
Maintain theme backups
Document all automated changes

Progressive Disclosure

For Basic Operations

Use the simple CLI commands for common tasks like product creation and theme updates.

For Advanced Integration

Refer to the full Shopify Admin GraphQL API documentation for complex mutations and queries.

Troubleshooting

Check API token permissions
Verify store URL format
Monitor rate limit headers
Review GraphQL error responses

API Version Compatibility

Current API version: 2024-10
Backward compatibility maintained
Regular version updates recommended

Support and Documentation

Shopify Admin API docs: https://shopify.dev/docs/api/admin-graphql
GraphQL best practices: https://shopify.dev/docs/apps/build/graphql-optimization
Rate limiting guide: https://shopify.dev/docs/api/usage/rate-limits

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @0-CYBERDYNE-SYSTEMS-0 · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: Required · Vendor-specific
Detected OS requirements: Unspecified
Runtime requirements: Python >=3.7
Detected file/system behavior: Read-only
Write / modify
Shell exec
Env read
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview shopify-operations.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Shopify Operations Skill

## Overview
This skill provides comprehensive Shopify store management capabilities through the Shopify Admin GraphQL API. It enables automated product creation, theme configuration, and store initialization.

## Core Capabilities

### 1. Product Management
- Create products with variants, pricing, and metadata
- Bulk product upload and catalog management
- Product image and media attachment
- Inventory and pricing management

### 2. Theme Configuration
- Apply JSON-based settings to active themes
- Configure colors, typography, and layout
- Update theme assets without manual Liquid editing
- Theme switching and customization

### 3. Store Operations
- Initialize store settings and policies
- Configure shipping zones and tax settings
- Set up navigation menus
- Manage store metadata and SEO

## Prerequisites

### Environment Setup
- Python 3.7+ with `requests` and `python-dotenv` packages
- Shopify Admin API access token (starts with `shpat_`)
- Store URL (format: `your-shop.myshopify.com`)

### Required Environment Variables
```bash
SHOPIFY_STORE_URL=your-shop.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_your_access_token_here
```

### Installation
```bash
pip install requests python-dotenv
```

## Usage Instructions

### Product Creation
```python
# Basic product creation
python3 scripts/shop_manager.py create_product \
  --title "Classic T-Shirt" \
  --price "29.99" \
  --vendor "MyBrand" \
  --tags "clothing,cotton" \
  --description "Comfortable 100% organic cotton t-shirt"
```

### Theme Configuration
```python
# Update theme settings
python3 scripts/shop_manager.py update_theme \
  --settings '{"colors": {"button": "#000000", "background": "#ffffff"}}'
```

### Store Information Update
```python
# Update shop settings

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Overview → Core Capabilities → 1. Product Management → 2. Theme Configuration → 3. Store Operations → Prerequisites
terms    -> All operations affect the live store immediately
files/cmd -> requests · python-dotenv · shpat · your-shop.myshopify.com · SHOPIFYSTOREURL
body sha256 -> 6cfe1048ece2