Flutter App Suite

Flutter App Builder — Skills Suite

Six skills covering the full pipeline of building and shipping a Flutter app, in the standard Agent Skills SKILL.md format (YAML frontmatter with description, then markdown instructions, with references/ and scripts/ bundled where useful).

This repo doubles as a Claude Code plugin marketplace: the six skills ship as a single bundled flutter-app-suite plugin.

Install in Claude Code (marketplace)

Run these as three separate commands inside a Claude Code session:

/plugin marketplace add https://github.com/Ionio-io/flutter-app-suit.git

/plugin install flutter-app-suite@flutter-app-suite

/reload-plugins

• Line 1 registers this repo as a marketplace. Use the full HTTPS URL with the .git suffix — the owner/repo shorthand can resolve to SSH and fail with Permission denied (publickey) if you have no SSH key. The repo is public, so HTTPS needs no credentials.
• Line 2 installs the bundled plugin (all six skills). The target is pluginName@marketplaceName — both are flutter-app-suite (from the JSON name fields), independent of the repo name.
• Line 3 activates it without restarting.

Update later with /plugin marketplace update flutter-app-suite. Skills then load automatically when their description triggers, or run one directly, e.g. /flutter-app-suite:flutter-app-dev.

If skills don't appear after install, run /reload-plugins; if still missing, rm -rf ~/.claude/plugins/cache, restart Claude Code, and reinstall.

Repo layout

flutter-app-suite/                 <- repo root = marketplace
├── .claude-plugin/marketplace.json
└── plugins/flutter-app-suite/     <- the plugin
    ├── .claude-plugin/plugin.json
    └── skills/                    <- the six SKILL.md folders
        ├── flutter-app-dev/  (+ references/)
        ├── app-store-listing/
        ├── play-store-listing/
        ├── app-logo-generation/
        ├── store-screenshots/  (+ scripts/)
        └── app-launcher-icons/

Skill	Use it for
flutter-app-dev	Building the app, design-first: a UI/UX philosophy (intentionality, thumb zone, 60/30/10 color, 8-pt grid, soft shadows, peak-end emotion) and a 5-step design process, then the two centerpieces — a 12–15 page value-selling onboarding (no generic avatar icons; charts, "normal vs this app" comparison) and a post-onboarding rating prompt — plus a bottom-nav shell. Flutter specifics (theme, flutter_animate, google_fonts, widget recipes) live in references/.
app-store-listing	iOS App Store ASO copy: title (30), subtitle (30), promotional text (150), description (4000, no emoji, + premium/subscription footer), keywords (100), optimized for organic search.
play-store-listing	Google Play ASO copy: app name (30), short description (80), full description (4000, + footer), optimized for Play's name+short+full ranking.
app-logo-generation	A paste-ready AI image prompt for a clean, text-free, 1024×1024 App Store icon, built from the app title + screenshots.
store-screenshots	N+1 AI image prompts for listing screenshots (1242×2688, promo lead + iPhone 17 framed shots), a resize script to force exact dimensions, and a Play feature-graphic (1024×500) prompt.
app-launcher-icons	Turning the AI logo into Android + iOS launcher icons via flutter_launcher_icons (adaptive icons, iOS no-alpha).

Install in Cursor and Antigravity (native skills)

SKILL.md is the same Agent Skills format Cursor (≥ 2.3) and Antigravity (≥ 1.20) now read natively — no rewriting, no .mdc conversion. A skill is a folder with SKILL.md plus optional references//scripts/, and each tool loads it on demand when your request matches the skill's description. The only thing that differs per tool is which directory the folders live in:

Tool	Project-scoped skills dir	Global skills dir
Claude Code	.claude/skills/ (or this plugin)	~/.claude/skills/
Cursor	.cursor/skills/	— (project-only)
Antigravity	.agent/skills/	~/.gemini/antigravity/skills/

Easiest: the included installer

Clone this repo, then run install.sh pointed at the tool (and, for project-scoped installs, your app's root):

git clone https://github.com/Ionio-io/flutter-app-suit.git
cd flutter-app-suit

./install.sh cursor       ~/code/my-flutter-app   # -> .cursor/skills/
./install.sh antigravity  ~/code/my-flutter-app   # -> .agent/skills/
./install.sh antigravity-global                   # -> ~/.gemini/antigravity/skills/
./install.sh all          ~/code/my-flutter-app   # Cursor + Antigravity + Claude

It copies the six skill folders (with their references//scripts/) into place. Reload the editor window afterward.

Or the ecosystem CLI

The community skills CLI auto-detects Claude Code, Cursor, Antigravity/Gemini, Codex, and more:

npx skills i Ionio-io/flutter-app-suit

Or by hand

Copy the folders from plugins/flutter-app-suite/skills/ into the directory from the table above and reload. Once installed, skills trigger on natural phrasing — "build my flutter app", "write my app store copy", "make store screenshots".

VS Code / Copilot has no native skills loader yet: paste a SKILL.md body into .github/copilot-instructions.md (or a custom-instructions file) and keep its references/ alongside for the model to read.

Typical flow

flutter-app-dev (build) → app-logo-generation (logo) → app-launcher-icons (apply logo) → store-screenshots (marketing images) → app-store-listing + play-store-listing (copy) → submit.

Package versions referenced (verify latest at build time)

flutter_animate ^4.5.2, google_fonts ^6.2.1, in_app_review ^2.0.10, shared_preferences ^2.3.0, fl_chart ^0.69.0, flutter_launcher_icons ^0.14.x. Always run flutter pub add <name> to let the resolver pick current versions.