gitwtfhub

wtf is codex-startup-user-simulator-skill?

kappaemme-git/codex-startup-user-simulator-skill — explained in plain English

Analysis updated 2026-05-18

32PythonAudience · pm founderComplexity · 2/5LicenseSetup · easy

TL;DR

A Codex skill that tests landing pages using five simulated customer personas to find conversion problems and suggest fixes.

Mindmap

mindmap
  root((user-simulator-skill))
    What it does
      Simulates five personas
      Finds conversion leaks
      Ranks fixes
    Tech stack
      Codex skill
      HTML report
    Use cases
      Landing page testing
      Before after comparison
      Copy review
    Audience
      Founders
      Product managers
    Modes
      Quick
      Deep
      Mobile
      Copy

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Test a landing page against five simulated customer personas to spot conversion leaks.

REASON 2

Compare an old and new version of a landing page with the same personas in before-after mode.

REASON 3

Get a prioritized list of fixes ranked by impact, effort, and confidence.

REASON 4

Rewrite the highest impact copy sections of a page using the copy mode focus.

What's in the stack?

PythonCodexHTML

How it stacks up

kappaemme-git/codex-startup-user-simulator-skillautolearnmem/automembilly-ellis/exr-imageio-poc
Stars323232
LanguagePythonPythonPython
Setup difficultyeasyhardmoderate
Complexity2/55/53/5
Audiencepm founderresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Codex Startup User Simulator Skill is a Codex skill that tests a startup, SaaS product, app, or landing page by simulating five distinct customer personas, each with their own reasons for converting, hesitating, or leaving. Instead of just describing a page, it inspects the real page, builds plausible decision makers based on the product's actual positioning, walks through each persona's conversion journey, and returns a set of prioritized fixes a founder could act on. It can test live URLs, apps running on localhost, screenshots, prototypes, or pasted copy. For each of the five simulated personas, it looks at clarity, relevance, trust, friction, and call to action problems, and it keeps observed evidence separate from inference and unknowns so the reader can tell what is fact versus guesswork. The output includes a scorecard comparing the five personas and ranks five suggested improvements by impact, effort, and confidence. It clearly labels the results as simulation, not as real user research. The default report includes a one sentence verdict, the biggest conversion leak, the five persona scorecard, evidence backed decision journeys, five prioritized fixes, the fastest measurable experiment to try next, and a note on the simulation's limitations. Codex also generates a polished, responsive HTML report saved to the workspace outputs folder, complete with expandable persona journeys, score visuals, a printable layout, and a save to PDF option. The skill supports five modes: quick for a fast verdict and top fixes, deep for a full desktop and mobile evaluation including pricing and CTA destinations, mobile for a small screen focused pass, before-after for comparing two versions of a page with the same personas, and copy for focusing specifically on positioning and headline language. It installs through npx or by manually copying the skill folder into the Codex skills directory, and Codex must be restarted afterward. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Use $startup-user-simulator to test my landing page URL with five simulated customer personas.
Prompt 2
Use $startup-user-simulator in deep mode to test my landing page for an indie founder audience aiming for free trial signups.
Prompt 3
Use $startup-user-simulator in before-after mode to compare these two landing page versions with the same five personas.
Prompt 4
Use $startup-user-simulator in copy mode to explain why customers may not understand my landing page and rewrite the top sections.

Frequently asked questions

wtf is codex-startup-user-simulator-skill?

A Codex skill that tests landing pages using five simulated customer personas to find conversion problems and suggest fixes.

What language is codex-startup-user-simulator-skill written in?

Mainly Python. The stack also includes Python, Codex, HTML.

What license does codex-startup-user-simulator-skill use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-startup-user-simulator-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codex-startup-user-simulator-skill for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.