improve-app SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 3 indexed copies. Same content hash, so the same checks give both the same grade.

improve-app from wondelai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wondelai/skills/improve-app@v2.0.2

Pins v2.0.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wondelai/skills
Path
improve-app/SKILL.md
Versions recorded
4
Latest version
v2.0.2, committed Aug 28, 2026
First version recorded
Jul 16, 2026
Size
24,645 bytes
Repository stars
2,472
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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

| Phase | Skill | Question it answers | Artifact |
|---|---|---|---|
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wondelai/skills/improve-app@sha256:c2843b034b11593c

The line at the top of this page pins the label v2.0.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mukouf5prd7cl4ep.svg)](https://markdownregistry.com/a/art_mukouf5prd7cl4ep)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Jul 16, 2026 and Aug 28, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
v2.0.2 latest2026-08-28 eee89d8 24,645 BA view · diff
v2.0.12026-08-09 21f45e4 24,641 BA view · diff
v2.0.02026-07-16 31f4a01 24,337 BA view · diff
v1.0.02026-07-16 6dd2ba4 25,934 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (24645 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wondelai/skills · 2,472 stars · license MIT · pushed 2026-09-10 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mukouf5prd7cl4ep
GET https://markdownregistry.com/api/v1/resolve?ref=wondelai/skills/improve-app
GET https://markdownregistry.com/api/v1/blob/c2843b034b11593cd7fee42cd1467bbf3a570cf29a707c3ac3f6ba7f6079ff69

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wondelai/skills

.cursorrules Cursor rule
wondelai/skills · .cursorrules
git:20260701.14a4958 · audit A · 2,472 stars
37signals-way SKILL.md skill
wondelai/skills · 37signals-way/SKILL.md · Build lean, opinionated products using the 37signals philosophy from "Getting Real", "Rework", and "Shape Up". Use when…
v1.3.1 · audit A · 2,472 stars
CLAUDE.md CLAUDE.md file
wondelai/skills · CLAUDE.md
git:20260829.6621b1f · audit A · 2,472 stars
architecture-optimization SKILL.md skill
wondelai/skills · architecture-optimization/SKILL.md · Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable…
v1.0.0 · audit A · 2,472 stars
blue-ocean-strategy SKILL.md skill
wondelai/skills · blue-ocean-strategy/SKILL.md · Create uncontested market space using value innovation instead of competing head-to-head. Use when the user mentions…
v1.4.1 · audit A · 2,472 stars
clean-architecture SKILL.md skill
wondelai/skills · clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
v1.4.0 · audit A · 2,472 stars
clean-code SKILL.md skill
wondelai/skills · clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
v1.4.0 · audit A · 2,472 stars
cold-start-problem SKILL.md skill
wondelai/skills · cold-start-problem/SKILL.md · Start and scale networked products using Andrew Chen''s "The Cold Start Problem" framework for network effects. Use…
v1.2.0 · audit A · 2,472 stars
contagious SKILL.md skill
wondelai/skills · contagious/SKILL.md · Engineer word-of-mouth and virality using the STEPPS framework (Social Currency, Triggers, Emotion, Public, Practical…
v1.4.0 · audit A · 2,472 stars
continuous-discovery SKILL.md skill
wondelai/skills · continuous-discovery/SKILL.md · Build a weekly cadence of customer touchpoints using Opportunity Solution Trees, assumption mapping, and interview…
v1.4.0 · audit A · 2,472 stars
conversion-optimization SKILL.md skill
wondelai/skills · conversion-optimization/SKILL.md · Guided journey from a leaking conversion flow - landing page, signup, checkout, or in-app onboarding - to a measured…
v1.0.0 · audit A · 2,472 stars
create-app SKILL.md skill
wondelai/skills · create-app/SKILL.md · Guided journey from a raw app idea to a validated, cleanly architected first version that ships on a sustainable…
v1.0.1 · audit A · 2,472 stars

Every file in wondelai/skills

Other files named improve-app

improve-app SKILL.md skill
wondelai/skills · plugins/metaskills/skills/improve-app/SKILL.md · Guided journey from a shipped app that works but feels rough to a product that fits the job, flows without friction…
v2.0.2 · audit A · 2,472 stars
improve-app SKILL.md skill
wondelai/skills · plugins/wondelai-skills/skills/improve-app/SKILL.md · Guided journey from a shipped app that works but feels rough to a product that fits the job, flows without friction…
v2.0.2 · audit A · 2,472 stars
improve-app SKILL.md skill
daishiman/harness-dev · aidd-agent-kit/codex/workflow-skills/improve-app/SKILL.md · 既存Webアプリへ機能追加・UX改善・不具合修正を1件ずつ安全に実装して公開する。Codexで「既存アプリを改善」「機能を追加」「$improve-app」と依頼されたときに使用する。
git:20261002.c0e127d · audit A · 10 stars
improve-app SKILL.md skill
daishiman/harness-dev · .agents/skills/improve-app/SKILL.md · 既存Webアプリへ機能追加・UX改善・不具合修正を1件ずつ安全に実装して公開する。Codexで「既存アプリを改善」「機能を追加」「$improve-app」と依頼されたときに使用する。
git:20261002.c0e127d · audit A · 10 stars

Browse by kind, by grade A, or by owner.