# flutter-improve-design

This skill checks a Flutter app against a design-rules catalog and surfaces UI/UX issues. Choose which findings should become implementation plans.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 515 installs · ★ 129
- Author: kamranbekirovyz
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kamranbekirovyz/skills/tree/HEAD/flutter-improve-design/SKILL.md
- Updated: 2026-08-02
- HTML: https://affpapa.org/en/nevibecode/skills/flutter-improve-design

## What it does

The skill loads the rules catalog, locates the Flutter app, then scans Dart files under `lib/`, skipping tests and generated files. It presents the findings and waits for you to choose which ones should get plans.

It writes selected findings and plans under `docs/improvements/design/`. It does not edit app source or run project-changing commands; read-only analysis may include `dart analyze`. The review depends on a fresh copy of the catalog. If that fetch fails, the review stops, so the catalog must be reachable before analysis can proceed.

Plans cover the selected rules and identify their locations in the code. The skill leaves implementation to you or a separate agent session; it will not apply the fixes itself.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add kamranbekirovyz/skills --skill flutter-improve-design -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add kamranbekirovyz/skills --skill flutter-improve-design -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add kamranbekirovyz/skills --skill flutter-improve-design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kamranbekirovyz/skills flutter-improve-design
```

2. **Manually: put the files in place**
- File: `.github/skills/flutter-improve-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add kamranbekirovyz/skills --skill flutter-improve-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/kamranbekirovyz/skills --path flutter-improve-design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add kamranbekirovyz/skills --skill flutter-improve-design -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/kamranbekirovyz/skills/tree/HEAD/flutter-improve-design/SKILL.md

## When to use it
- inspect Flutter UI code against a design-rules catalog
- surface interface issues for developer review
- turn selected findings into standalone implementation plans
- trace every occurrence of a chosen rule across the app

## Example prompts
- Review my Flutter app against the catalog and show the design issues you find.
- Create plans for findings 1 and 3, and leave the app source unchanged.
- Recheck the selected rule across the whole app and write a complete implementation plan.

## Similar
- [flutter-animating-apps](https://affpapa.org/en/nevibecode/skills/flutter-animating-apps.md) — skill · 2900 installs
- [shadcn-ui-flutter](https://affpapa.org/en/nevibecode/skills/shadcn-ui-flutter.md) — skill · 678 installs
- [improve-animations](https://affpapa.org/en/nevibecode/skills/improve-animations.md) — skill · 224200 installs
- [improve-ui](https://affpapa.org/en/nevibecode/skills/improve-ui.md) — skill · 7900 installs
- [improve-website](https://affpapa.org/en/nevibecode/skills/improve-website.md) — skill · 2300 installs
- [improve-app](https://affpapa.org/en/nevibecode/skills/improve-app.md) — skill · 2200 installs

---
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