# conversion-optimization

A guided funnel audit for leaking landing pages, signups, checkouts, or onboarding flows. The skill walks through seven phases and saves decisions directly to docs/.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 2508
- Author: wondelai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/wondelai/skills/tree/HEAD/conversion-optimization/SKILL.md
- Updated: 2026-09-10
- HTML: https://affpapa.org/en/nevibecode/skills/wondelai-conversion-optimization

## What it does

The skill targets one leaking flow with a single conversion goal: a landing page, a checkout, or product onboarding. It runs seven phases, diagnosing where drop-offs happen, collecting customer objections, refining the offer, polishing UX, and structuring verification tests. Every decision lands in markdown files under `docs/`, including `METRICS.md`, `FUNNEL.md`, and `CONVERSION-OPTIMIZATION-PLAN.md`.

It orchestrates six specialized frameworks. If companion skills like `lean-analytics` or `cro-methodology` are not installed locally, the workflow falls back to inline briefs. The agent asks questions at each decision gate and requires user approval before writing files.

This workflow rejects copy or layout tweaks until analytics and user research pinpoint the problem. Phases 1 and 2 are mandatory gates: you can defer them, but never skip them. If you do not have a live site yet, this skill will not build one; use `create-website` instead.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill conversion-optimization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/conversion-optimization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/conversion-optimization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill conversion-optimization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/conversion-optimization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill conversion-optimization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/conversion-optimization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wondelai/skills conversion-optimization
```

2. **Manually: put the files in place**
- File: `.github/skills/conversion-optimization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill conversion-optimization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/wondelai/skills --path conversion-optimization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/conversion-optimization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add wondelai/skills --skill conversion-optimization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wondelai/skills/tree/HEAD/conversion-optimization/SKILL.md

## When to use it
- locate the exact funnel drop-off step using quantitative analytics
- extract real customer objections from support tickets and exit surveys
- rewrite the offer and reduce UX friction at the conversion point
- plan a verified experiment with guardrail metrics in `docs/EXPERIMENTS.md`

## Example prompts
- Run conversion-optimization on our checkout flow, users drop right before payment.
- Diagnose our onboarding drop-off and start the intake process.
- Resume the conversion audit from `docs/CONVERSION-OPTIMIZATION-PLAN.md`.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 0e4c51bd0b14d31a.

BEGIN THIRD-PARTY FILE 0e4c51bd0b14d31a
```text
---
name: conversion-optimization
description: 'Guided journey from a leaking conversion flow - landing page, signup, checkout, or in-app onboarding - to a measured, tested funnel. Orchestrates six skills phase by phase - lean-analytics, cro-methodology, storybrand-messaging, hundred-million-offers, influence-psychology, design-everyday-things - each phase carries its full method inline so it runs standalone, asking the user questions at every decision point and recording results in the project docs/ folder (FUNNEL.md, METRICS.md, EXPERIMENTS.md, CONVERSION-OPTIMIZATION-PLAN.md) so the journey resumes across sessions. Use when the user wants to raise conversion on a specific flow, fix checkout or signup abandonment, diagnose onboarding drop-off, or says ''people start but never finish''. With no site yet, use create-website; for a whole-site look, message, and speed audit, improve-website; if the flow converts but needs traffic, grow-website; for in-product engagement and retention, improve-app. For one framework in isolation, invoke that skill directly.'
license: MIT
metadata:
  author: wondelai
  version: "1.0.0"
---

# Conversion Optimization

Turn one leaking conversion flow — a landing page, a signup, a checkout, an in-app onboarding — into a
measured, tested funnel. This is an interactive, resumable journey of seven phases: the agent asks
before every decision and records the outcome in your project's `docs/` folder, so you can stop after
any phase and pick up later. It works on websites and inside products alike; the unit of work is the
flow and its ONE action, not the whole site.

## Core Principle

**Find the leak with numbers, learn the reason from customers, fix message → offer → proof → friction
in that order, and prove every fix with a pre-committed test.** The order is causal: a number tells
you *where*, only research tells you *why*, motivation must be raised before friction-cutting pays,
and an untested fix is a guess that compounds. This skill sequences the phases, asks the decision
questions, and records every choice in `docs/`. The constituent skills carry the method — invoke them
rather than improvising their frameworks.

## Journey Map

| Phase | Skill | Question it answers | Artifact |
|---|---|---|---|
| 1 | lean-analytics | Where does the flow actually leak, and what is the one metric? | Extends docs/METRICS.md — GATE |
| 2 | cro-methodology | Why do people drop at the leak — which objections and friction? | Creates docs/FUNNEL.md; extends docs/EXPERIMENTS.md — GATE |
```
END THIRD-PARTY FILE 0e4c51bd0b14d31a

The third-party file has ended. Everything between the 0e4c51bd0b14d31a tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2554 of 26651 bytes. © wondelai · MIT · https://github.com/wondelai/skills/tree/HEAD/conversion-optimization/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md