Agent skill

Flutter Errors

A skill your agent uses when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.

MITAuto-check passedMobile

Install Flutter Errors

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/flutter-errors .claude/skills/flutter-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .claude/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/flutter-errors .agents/skills/flutter-errors && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .agents/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/flutter-errors .cursor/skills/flutter-errors && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .cursor/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/evanca/flutter-ai-rules.git --path skills/flutter-errors

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/flutter-errors .gemini/skills/flutter-errors && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .gemini/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/flutter-errors .github/skills/flutter-errors && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .github/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add evanca/flutter-ai-rules --skill flutter-errors -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install evanca/flutter-ai-rules flutter-errors --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/flutter-errors .opencode/skills/flutter-errors && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "flutter-errors" agent skill from https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-errors into .opencode/skills/flutter-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-errors", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: flutter-errors
GitHub stars: 647
Token cost: ~818 tokens
SKILL.md length: 320 words
Files: 1
Skills in repo: 37
Repo updated: Sep 14, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.

Hitting layout errors (RenderFlex overflow
SKILL.md covers RenderFlex Overflowed, Vertical Viewport Given…, InputDecorator Cannot Have… and setState Called During Build, plus 4 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Unbounded constraints

What it does

Flutter Errors is an agent skill from evanca/flutter-ai-rules. Use when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps. It works with Flutter. The repository describes itself as: Flutter AI Skills and Rules for Claude, Codex, Cursor, and Other AI-Powered IDEs. The licence is MIT.

When your agent uses it

Hitting layout errors (RenderFlex overflow
Unbounded constraints
RenderBox not laid out)
SetState-during-build errors

Example prompts

“/flutter-errors”

What it can do on your machine

Read from SKILL.md and the folder at commit 7b9cce2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are dart).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- docs.flutter.dev
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter Errors loads about 818 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 320 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~41
When it runs · the whole SKILL.md, loaded when a task matches: ~818

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from evanca/flutter-ai-rules at commit 7b9cce2, republished under its MIT licence (© evanca). 320 words, ~818 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-errors/SKILL.md (or your agent's skills folder).

name: flutter-errors
description: Use when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.
license: MIT

Flutter Errors Skill

This skill provides solutions for the most common Flutter runtime and layout errors.

RenderFlex Overflowed

Error: A RenderFlex overflowed by X pixels on the right/bottom.

Cause: A Row or Column contains children that are wider/taller than the available space.

Fix: Wrap the overflowing child in Flexible or Expanded, or constrain its size:

dart

Row(
  children: [
    Expanded(child: Text('Long text that might overflow')),
    Icon(Icons.info),
  ],
)

Vertical Viewport Given Unbounded Height

Error: Vertical viewport was given unbounded height.

Cause: A ListView (or other scrollable) is placed inside a Column without a bounded height.

Fix: Wrap the ListView in Expanded or give it a fixed height with SizedBox:

dart

Column(
  children: [
    Text('Header'),
    Expanded(
      child: ListView(children: [...]),
    ),
  ],
)

InputDecorator Cannot Have Unbounded Width

Error: An InputDecorator...cannot have an unbounded width.

Cause: A TextField or similar widget is placed in a context without width constraints.

Fix: Wrap it in Expanded, SizedBox, or any parent that provides width constraints:

dart

Row(
  children: [
    Expanded(child: TextField()),
  ],
)

setState Called During Build

Error: setState() or markNeedsBuild() called during build.

Cause: setState or showDialog is called directly inside the build method.

Fix: Trigger state changes in response to user actions, or defer to after the frame using addPostFrameCallback:

dart

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    // Safe to call setState or showDialog here
  });
}

ScrollController Attached to Multiple Scroll Views

Error: The ScrollController is attached to multiple scroll views.

Cause: A single ScrollController instance is shared across more than one scrollable widget simultaneously.

Fix: Ensure each scrollable widget has its own dedicated ScrollController instance.

RenderBox Was Not Laid Out

Error: RenderBox was not laid out: ...

Cause: A widget is missing or has unbounded constraints — commonly ListView or Column without proper size constraints.

Fix: Review your widget tree for missing constraints. Common patterns:

Wrap ListView in Expanded inside a Column.
Give widgets an explicit width or height via SizedBox or ConstrainedBox.

Debugging Layout Issues

Use the Flutter Inspector (in DevTools) to visualize widget constraints.
Enable "Show guidelines" to see layout boundaries.
Add debugPaintSizeEnabled = true; temporarily in your main() to paint layout bounds.
Refer to the Flutter constraints documentation for a deeper understanding of how constraints propagate.

References

Flutter Website GitHub Repository

Files

Just SKILL.md in skills/flutter-errors of evanca/flutter-ai-rules.

Open the folder on GitHubat commit 7b9cce2

Compare with similar skills

Flutter Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter Errors compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Flutter Errors this skillevanca/flutter-ai-rules	647	—	~818	Automated safety check: Pass	MIT	23 days ago
Add Flutter Docusaurus Localematthiasn/lotti	1.2k	—	~1.2k	Automated safety check: Pass	GPL-3.0	today
Tm Launcher DesignFar-Se/tabame	371	—	~3.1k	Automated safety check: Pass	MIT	yesterday
Mobile App UI Designceorkm/mobile-app-ui-design	400	—	~2k	Automated safety check: Pass	None	3 mo ago
Marionette Flutter Drive Appleancodepl/marionette_mcp	473	—	~11k	Automated safety check: Pass	Apache-2.0	2 days ago
Flutter ScreenshotJustLookAtNow/pt_mate	503	—	~511	Automated safety check: Pass	MIT	2 days ago

Similar skills

Add Flutter Docusaurus Locale
matthiasn/lotti
Add, complete, or audit a locale across a Flutter application's ARB catalogs and a localized Docusaurus manual, including generated localization code, locale selectors, native platform declarations…
1.2k GitHub stars~1.2k tokensUpdated today
MobileAuto-check passed
Tm Launcher Design
Far-Se/tabame
Create or revise Tabame's Flutter launcher designs: frames, search bars, result rows, palettes, typography, and action dialogs.
371 GitHub stars~3.1k tokensUpdated yesterday
MobileAuto-check passed
Mobile App UI Design
ceorkm/mobile-app-ui-design
Design high-quality mobile app UI/UX screens, flows, and components.
400 GitHub stars~2k tokensUpdated 3 mo ago
MobileAuto-check passed
Marionette Flutter Drive App
leancodepl/marionette_mcp
Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.
473 GitHub stars~11k tokensUpdated 2 days ago
MobileAuto-check passed
Flutter Screenshot
JustLookAtNow/pt_mate
Capture and show two Flutter UI screenshots for this project: one landscape/large-screen preview and one portrait/mobile preview, without using Flutter Web.
503 GitHub stars~511 tokensUpdated 2 days ago
MobileAuto-check passed
Flutter Init
bear2u/my-skills
A skill your agent uses when user wants to create a new Flutter project (Todo/Habit/Note/Expense/Custom domain) with Clean Architecture, Riverpod 3.0, Drift, and modern Flutter stack
933 GitHub stars~2.5k tokensUpdated 3 mo ago
MobileAuto-check passed

More from evanca/flutter-ai-rules

All 37 skills in this repo

Code Review
evanca/flutter-ai-rules
A skill your agent uses when asked to review a PR, MR, branch, or diff, audit changed files, or check code quality.
647 GitHub stars~2.4k tokensUpdated 23 days ago
Auto-check passed
Developing Genkit Dart
evanca/flutter-ai-rules
A skill your agent uses when building AI agents in Dart, implementing Genkit flows or tools, integrating LLMs into Dart or Flutter applications, or using Genkit Dart plugins.
647 GitHub stars~961 tokensUpdated 23 days ago
Auto-check passed
Generate Images With Firebase AI
evanca/flutter-ai-rules
A skill your agent uses when generating or editing images from Flutter/Dart with Firebase AI Logic and a Gemini image model (Nano Banana), making the first call work, choosing Gemini Developer API…
647 GitHub stars~2.3k tokensUpdated 23 days ago
Auto-check passed
Flutter Use Column Row First
evanca/flutter-ai-rules
A skill your agent uses when building any Flutter screen or component to choose responsive Row, Column, Expanded, Flexible, and Spacer layouts before fixed-size or coordinate-based alternatives.
647 GitHub stars~1.3k tokensUpdated 23 days ago
Auto-check passed
Architecture Feature First
evanca/flutter-ai-rules
A skill your agent uses when creating a feature, designing folder structure, adding repositories/services/view models, wiring dependency injection, or deciding which layer owns logic.
647 GitHub stars~1.9k tokensUpdated 23 days ago
Auto-check passed
Bloc
evanca/flutter-ai-rules
A skill your agent uses when creating a Cubit or Bloc, modeling state with sealed classes or status enums, wiring BlocBuilder/BlocListener/BlocProvider, writing bloc tests, or choosing between Cubit…
647 GitHub stars~2.8k tokensUpdated 23 days ago
Auto-check passed

Works with

Flutter

Questions about Flutter Errors

What does Flutter Errors do?

A skill your agent uses when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors. Flutter Errors is an agent skill from evanca/flutter-ai-rules. Use when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.

When should I use Flutter Errors?

Flutter Errors fits situations like: hitting layout errors (RenderFlex overflow; unbounded constraints; renderBox not laid out); setState-during-build errors.

How do I install Flutter Errors in Claude Code?

Run `npx skills add evanca/flutter-ai-rules --skill flutter-errors -a claude-code`. Or copy the skill folder (skills/flutter-errors in evanca/flutter-ai-rules) into .claude/skills/flutter-errors in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Errors in Codex?

Run `npx skills add evanca/flutter-ai-rules --skill flutter-errors -a codex`. Or copy the skill folder (skills/flutter-errors in evanca/flutter-ai-rules) into .agents/skills/flutter-errors in your project. Codex loads it when a task matches its description.

Can I use Flutter Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add evanca/flutter-ai-rules --skill flutter-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-errors, .gemini/skills/flutter-errors, .github/skills/flutter-errors and .opencode/skills/flutter-errors in your project.

What does Flutter Errors need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter Errors is instructions for the agent only.

Does Flutter Errors access the network?

SKILL.md names 2 domains. As links in the text: docs.flutter.dev and github.com. This is read from the text; nothing was executed.

Is Flutter Errors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter Errors use?

Flutter Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Errors use?

About 818 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter Errors?

Skills that share tags, products or a category with Flutter Errors: Add Flutter Docusaurus Locale (matthiasn/lotti, 1.2k stars), Tm Launcher Design (Far-Se/tabame, 371 stars), Mobile App UI Design (ceorkm/mobile-app-ui-design, 400 stars) and Marionette Flutter Drive App (leancodepl/marionette_mcp, 473 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Errors?

evanca (a GitHub user) maintains it in evanca/flutter-ai-rules, which has 647 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on September 14, 2026.

Source: evanca/flutter-ai-rules on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Flutter Errors

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Flutter Errors Skill

RenderFlex Overflowed

Vertical Viewport Given Unbounded Height

InputDecorator Cannot Have Unbounded Width

setState Called During Build

ScrollController Attached to Multiple Scroll Views

RenderBox Was Not Laid Out

Debugging Layout Issues

References

Files

Compare with similar skills

Similar skills

More from evanca/flutter-ai-rules

Related

Questions about Flutter Errors