# Skill Packs

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

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

Skill Packs teach your AI coding assistant how to build high-converting Shopify pages. Combined with the Lexsis AI MCP server, your AI can plan, generate, publish, and optimize complete storefronts.

## How It Works

```
Skills = WHAT to build (conversion psychology, vertical expertise, workflows)
MCP    = HOW to build it (tools: generate images, publish pages, run A/B tests)
```

Run setup once for the stores and themes you use:

```text
/setup
```

Then use the normal page workflow:

```text
/plan-page → /design-page → /generate → /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.

`/asset-prep` is optional and is used only when the page needs standalone or
replacement media work.

## 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 (10)

| 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 |
| `/design-page` | Build canonical source and an interactive responsive preview |
| `/asset-prep` | Replace temporary media with verified production assets |
| `/generate` | Return `DRAFT_CREATED` early, then upgrade it to `DRAFT_READY` after hosted QA |
| `/publish` | Release a synchronized draft after explicit approval |
| `/analyze-page` | Analyze a URL, screenshot, ad, or existing page |
| `/optimize` | Improve an existing page for a chosen business outcome |
| `/experiment` | Create and evaluate focused storefront experiments |
| `/cart` | Inspect, assign, and edit cart profiles |

`/setup` stores slow-changing brand guidance and separate theme CSS files for
each selected store/theme pair. Products, prices, variants, assets, island
schemas, permissions, and remote versions are still read live.

The page workflow maintains readable local artifacts. `/design-page` can
regenerate local previews repeatedly, while `/generate` owns unpublished draft
creation, synchronization, and the QA report. Reversible ambiguity defaults to
a fast draft. `/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.