# Improve App

Guided journey from a shipped app that works but feels rough to a product that fits the...

- Repository: https://github.com/wondelai/skills (2552 stars)
- Category: Design
- License: MIT
- Last updated: 2026-09-10
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add wondelai/skills --skill improve-app -g -a claude-code -y`
Codex: `npx skills add wondelai/skills --skill improve-app -g -a codex -y`
Cursor: `npx skills add wondelai/skills --skill improve-app -g -a cursor -y`
Gemini CLI: `npx skills add wondelai/skills --skill improve-app -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add wondelai/skills`

## Description

Guided journey from a shipped app that works but feels rough to a product that fits the job, flows without friction, reads clearly, and persuades honestly. Orchestrates nine skills phase by phase - jobs-to-be-done, ux-heuristics, design-everyday-things, refactoring-ui, microinteractions, made-to-stick, influence-psychology, high-perf-browser, steve-jobs-design-review - asking the user questions at every decision point and recording results in the project docs/ folder (CUSTOMER.md, DESIGN.md, POSITIONING.md, IMPROVE-APP-PLAN.md) so the journey resumes across sessions. Use when the user wants to fix a clunky product, cut UX friction, sharpen in-app copy, or says ''the app works but feels rough''. Not for code, tests, or hardening - use improve-code-quality (fresh prototype) or remove-technical-debt (aged); no app yet, create-app; needs growth loops, grow-app; marketing-site friction, improve-website; one leaking flow, conversion-optimization. For one framework in isolation, invoke that skill directly.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Improve an App

The app already ships and works, users, screens, a real flow, but the experience feels rough where it
should feel effortless. Across nine phases this journey fixes what users feel, in evidence order: re-anchor
on the job, remove friction, polish the look and the moments, sharpen the words, persuade honestly, and end
with a review brutal enough to cut. It is interactive (the agent asks before deciding) and resumable (state
lives in `docs/`). Code-level causes route out to the code journeys, this pass fixes the product experience.

## Core Principle

**Fix what users feel, in evidence order: re-anchor on the job the app is hired for, remove friction before
polish, sharpen the words, persuade honestly, and end with a review brutal enough to cut.** A prettier
screen on a confusing flow loses users at the same rate, the order of the phases is the whole game.

This skill sequences the phases, asks the decision questions, and records what you decide. The nine
constituent skills carry the method, invoke them rather than improvising their frameworks.

## Journey Map

The rest: https://github.com/wondelai/skills/blob/HEAD/improve-app/SKILL.md