Guided Journey · Improve × App

Improve an App

Product, UX, copy, and in-app persuasion — fix what users feel

Takes you from a shipped app that works but feels rough to a product that fits the job, flows without friction, reads clearly, and persuades honestly. It orchestrates its nine skills phase by phase, asking you the decision questions at every step and recording every result in your project's docs/ folder so the journey resumes across sessions.

Written to your repo
  • docs/CUSTOMER.md
  • docs/DESIGN.md
  • docs/EXPERIMENTS.md
  • docs/POSITIONING.md
  • docs/PRODUCT.md
  • docs/IMPROVE-APP-PLAN.md journey tracker — stop anytime, resume any session

One prompt runs it

Every phase asks before it acts, and every decision lands in your project’s docs/ folder as a living document — quit anytime, resume in any session.

Use it when you need to
  • Re-anchor the app on the job users actually hire it for
  • Remove usability friction with severity-ranked audits before any visual polish
  • Fix hierarchy, spacing, and microinteraction detail so screens feel professional
  • Rewrite in-app copy (onboarding, empty states, errors, CTAs) so it lands
  • Make paywalls and upgrade prompts persuade honestly, then face a cold final review
Install this metaskill
npx skills add wondelai/skills/improve-app --global

This skill is compatible with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent, and other agentskills.io-compatible agents.

Journey Map

9 phases, one deliberate order

Each phase invokes one skill from the library, asks you the decision question, and writes the answer to your project’s docs/ before moving on.

  1. 01 What job is the app hired for, and where does it underdeliver? Jobs to Be Done jobs-to-be-done → docs/CUSTOMER.md Gate
  2. 02 Where does the interface make users stop and think? UX Heuristics ux-heuristics → docs/DESIGN.md + docs/EXPERIMENTS.md
  3. 03 Where do users act wrong because the design misled them? Design of Everyday Things design-everyday-things → docs/DESIGN.md + docs/EXPERIMENTS.md
  4. 04 Does the app look as clear as it works? Refactoring UI refactoring-ui → docs/DESIGN.md + docs/EXPERIMENTS.md
  5. 05 Does every action feel alive, or dead? Microinteractions microinteractions → docs/DESIGN.md + docs/EXPERIMENTS.md
  6. 06 Do the in-app words land, or read as jargon? Made to Stick made-to-stick → docs/POSITIONING.md + docs/EXPERIMENTS.md
  7. 07 Do the paywall and upgrade moments persuade honestly? Influence Psychology influence-psychology → docs/POSITIONING.md + docs/EXPERIMENTS.md
  8. 08 Does the app feel fast where users touch it? High Perf Browser high-perf-browser → docs/DESIGN.md + docs/EXPERIMENTS.md
  9. 09 Is the whole experience insanely great, or just better? Steve Jobs Design Review steve-jobs-design-review → docs/PRODUCT.md + docs/DESIGN.md + docs/EXPERIMENTS.md
In Practice

Make an App Feel as Good as It Works

The app is functional, but users call it confusing, the screens feel rough, and upgrade prompts convert nobody.

Our app works but the experience underwhelms: [paste symptoms —
confusing flows, rough screens, ignored upgrade prompts]. Run the
improve-app journey — product fit, UX audit, visual polish,
microinteractions, in-app copy, and honest persuasion — ending
with a brutal review. Track findings and fixes in docs/.

Use improve-app skill.
Example Prompts

Try these with the skill installed

The app works but feels rough and users say it's confusing — improve the experience end to end. using improve-app skill

Experience overhaul

Run the improve-app journey; start by checking what job users hire us for. using improve-app skill

Journey kickoff

Continue improving the app from where the tracker says we stopped. using improve-app skill

Resume journey
The Source

Born from a guide

This journey packages the playbook below as a single skill — the guide is the long-form read behind every phase.

Improve · App

How to Improve an Existing App with AI Skills

Fix how a shipped app feels — product fit, UX friction, visual hierarchy, microinteractions, in-app copy, and honest persuasion — with AI agent skills from Competing Against Luck, Don't Make Me Think, Refactoring UI, Influence, and more.

16 min read
More Journeys

Twelve journeys, one library

Create · Business

Create a Business

10 phases Create · Website

Create a Website

10 phases Create · App

Create an App

10 phases Improve · Business

Improve a Business

8 phases Improve · Website

Improve a Website

8 phases Grow · Business

Grow a Business

9 phases Grow · Website

Grow a Website

8 phases Grow · App

Grow an App

8 phases Engineering

Improve Code Quality

9 phases Engineering

Remove Technical Debt

8 phases Engineering

Design Code Architecture

8 phases

Install Improve an App

Free, open-source, and ready in 30 seconds.

npx skills add wondelai/skills/improve-app --global
Browse on GitHub See All Skills

MIT Licensed · Works with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent & other agentskills.io agents · No account needed

Prove it

Don’t guess your AI engineering level.
Measure it.

25 questions · ~8 min · Free

For hands-on developers

AI Developer Scorecard

How production-grade is your AI engineering?

Twenty-five questions across the practices that separate vibe-coding from production-grade engineering. Instant score, per-section breakdown, and a 30/60/90-day playbook.

Score 0–75 · 30/60/90-day playbook Score yourself For CTOs & founders

CTO Scorecard

Is your engineering team ready for AI at scale?

Twenty-five questions on how your org adopts AI — adoption, governance, automation, and ROI. See where you sit on the path from Reactive to Strategic Leader.

Score 0–75 · Reactive → Strategic Leader Score your org
Work with us

We build the skills you already use. Now we’ll build yours.

Custom skills · Subagents · MCP integrations — shipped to production, not demoed.

See what we build Book a 15-min call

Sprints from $3K · shipped to production, or you don’t pay the final milestone.