# Skill Packs

> Install AI expert knowledge for your coding assistant. Works with Claude Code, OpenAI Codex, Cursor, and Custom GPTs.

Canonical URL: https://c22dfdd27662:3005/getting-started/skill-packs

Skill Packs teach your AI coding assistant how to build high-converting
Shopify pages and guided shopping journeys. Combined with the Lexsis AI MCP
server, your AI can plan, design, create, preview, publish, and optimize
storefront experiences.

## How It Works

```
Skills = WHAT workflow to follow and which safety boundaries apply
MCP    = HOW to read and change Lexsis storefront state
```

Run setup once for the stores and themes you use:

```text
/setup
```

Then use the normal page workflow:

```text
/plan-page → /visualize-page (optional) → /plan-assets → /design-page → /publish
```

Each command owns one result and remains independently invokable. Commands do
not silently run `/setup` or another skipped skill on the user's behalf.
The workflow infers whether the user wants a fast reversible draft or
production-ready verification from the complete request. It does not require a
special phrase.

`/optimize`, `/ab-test`, and `/cart` are independent operations.
They are not required stages in the page workflow.

## Install Skills + MCP

Run one command to install the full Lexsis storefront skill pack and configure
the hosted Lexsis MCP for your selected AI client:

```bash
curl -fsSL https://mcp.trylexsis.com/install.sh -o /tmp/lexsis-install.sh && sh /tmp/lexsis-install.sh
```

The installer detects Claude Code, Codex, Cursor, and Claude Desktop. Choose
one or more destinations, or press Enter to install into every detected client.
For Claude Code, Codex, and Cursor it installs all Lexsis skills and adds the
MCP server. Claude Desktop receives the MCP only because it does not support
Agent Skills.

After installation, restart your AI client. On the first Lexsis tool call, the
client opens OAuth. Sign in to Lexsis, select the workspaces to share, and
choose Read, Build, or Publish access. No API key is requested or written to a
configuration file.

### Install Specific Clients

```bash
# Codex, including every Lexsis storefront skill
sh /tmp/lexsis-install.sh codex

# Claude Code in the current project
sh /tmp/lexsis-install.sh claude-project

# Cursor in the current project
sh /tmp/lexsis-install.sh cursor-project

# Inspect changes without writing configuration
sh /tmp/lexsis-install.sh --dry-run auto
```

Use `--skip-skills` only when you want an MCP-only installation.

## Update Installed Skills

Refresh skills installed through the Skills CLI from their original source
repositories:

```bash
npx skills update
```

Choose **Global** when prompted to update globally installed skills. The
command checks every registered skill source, shows available updates, and
updates the installed skills in place. Restart or reload your AI client after
the update so it discovers the latest skill instructions.

### Verify the Installer

```bash
curl -fsSL https://mcp.trylexsis.com/manifest.json
shasum -a 256 /tmp/lexsis-install.sh
```

## Manual Installation

### Claude Code

```bash
# Register marketplace (one-time)
/plugin marketplace add lexsis https://github.com/Aetheria-Labs1/storefront-skills

# Install core skills
/plugin install lexsis-storefront-skills@lexsis

```

The core package includes every supported vertical. No separate vertical
install is needed.

### OpenAI Codex

```bash
# Register marketplace (one-time)
codex plugin marketplace add Aetheria-Labs1/storefront-skills --ref main

# Install
codex plugin add lexsis-storefront-skills@lexsis-storefront
```

Complete the OAuth prompt when Codex requests MCP access.

### Cursor

```bash
npx skills add Aetheria-Labs1/storefront-skills --skill '*' --agent cursor --yes
```

### Custom GPT

1. Copy `gpt/instructions.md` → paste into GPT Instructions
2. Upload `gpt/knowledge.md` as a Knowledge file

## What's Included

### Storefront Commands (9)

| Command | What it does |
|---------|-------------|
| `/setup` | Save reusable brand and theme context for one or more stores |
| `/plan-page` | Create a page plan at the depth implied by the request |
| `/visualize-page` | Create optional mobile-first concept frames for review |
| `/plan-assets` | Resolve and verify production assets |
| `/design-page` | Create and responsively verify one unpublished hosted page draft |
| `/publish` | Release a `DESIGN_APPROVED` page version after explicit approval |
| `/optimize` | Improve an existing page for a chosen business outcome |
| `/ab-test` | Create or evaluate a focused draft A/B test |
| `/cart` | Inspect, assign, and edit cart profiles |

`/setup` stores slow-changing brand and theme guidance. Products, prices,
variants, assets, island schemas, permissions, and remote versions are still
read live.

`/design-page` authors the approved page directly through MCP, creates one
unpublished hosted draft, and performs responsive review. `/publish` remains a
separate live operation with explicit approval.

### Agents (2)

| Agent | What it does |
|-------|-------------|
| **cro-analyzer** | 12-point CRO audit of any page URL → outputs a blueprint |
| **page-builder** | Guides the staged page workflow from setup context through a reviewed draft |

### Knowledge Skills

Expert domain knowledge loaded on-demand via `vibe://skills/{name}`:
- **Conversion psychology** — AIDA framework, section ordering, CTA patterns, urgency tactics
- **Vertical expertise** — Industry-specific design (beauty, supplements, fashion, food, luxury, home)
- **Traffic source strategy** — Platform-optimized patterns (Meta, Google, TikTok)
- **Visual craft** — Typography, spacing, color, micro-interactions
- **Asset pipeline** — Multi-source image/video strategy (built-in + external MCPs)

## Vertical Expertise (Included)

Industry-specific CRO patterns are included in the core plugin — no separate install needed. Loaded on-demand via `vibe://skills/vertical-{name}`:

| Vertical | Loaded when... |
|----------|---------------|
| Beauty | Skincare, haircare, fragrance, cosmetics products |
| Supplements | Vitamins, protein, nootropics, fitness |
| Fashion | Clothing, shoes, accessories, streetwear |
| Food | Food, coffee, snacks, meal kits, beverages |
| Luxury | Jewelry, watches, designer goods (AOV > $300) |
| Home | Furniture, decor, candles, textiles |

## Credits

Some MCP tools consume credits:

| Operation | Cost |
|-----------|------|
| `lexsis_drafts` → `asset_generate` | Model-based: 1 credit for `gemini-3.1-flash-lite-image`, `gemini-3.1-flash-image`, `gemini-2.5-flash-image`, and `openai/gpt-image-2`; 2 credits for `gemini-3-pro-image` |
| `lexsis_page_create` → `create` | Credits |
| `lexsis_drafts` → `experiment_create` / `page_variation` | Credits (Pro plan) |
| All read/search/validate tools | **Free** |

Check balance with `lexsis_workspace` → `credits`.

## Connect MCP Server Manually

Use this only for MCP clients not supported by the installer. Supported clients
should use the combined installer above so the skills and MCP stay aligned.

```json
{
  "mcpServers": {
    "lexsis-ai": {
      "type": "http",
      "url": "https://mcp.trylexsis.com/mcp"
    }
  }
}
```

Restart the client and complete the OAuth prompt when it connects.