Flutter AI Skills and Rules for Cursor, Copilot, Antigravity, and Other AI-Powered IDEs

⚡ TLDR

Primary method: Copy skill folders from `skills/` into your IDE's skills directory (e.g., .cursor/skills/, .windsurf/skills/). The agent will automatically use relevant skills based on your tasks.

For traditional rules: If you want to use .cursor/rules or .windsurfrules, just copy the contents of the rule set of your choice (e.g., combined/flutter_dart__under_6K.md) into your IDE's global or local rules. For maximum control, you can also copy the /rules folder into your project and reference rules as needed (e.g., "Read @rules/firebase/ and set up a project with Realtime Database, App Check, and Analytics.").

🚀 Introduction

This repository provides a comprehensive, (almost) non-opinionated collection of Flutter-related rules tailored for use with Windsurf, Cursor, and other AI-powered IDEs. These rules are designed to improve your development workflow, ensure consistency, and help you get the most out of your AI coding assistant.

📁 Repository Structure

• `skills/`

NEW! Skills are an open standard for extending agent capabilities. A skill is a folder containing a SKILL.md file with instructions that the agent can follow when working on specific tasks. They are essentially what “dynamic rules” used to be — applied automatically when the agent determines they are relevant based on the description.

Copy or symlink any skill folder into .cursor/skills/, .agent/skills/, or another supported location.

• `rules/`

Contains individual rule files, each focused on a specific topic or tool (e.g., bloc.md, effective_dart.md, etc.). These files are:

• Based only on official documentation from Flutter, Dart, or relevant package websites.
• Categorized by subject to make them easy to mix, match, and reference.
• Meant to be refined, adjusted, or extracted based on your project needs.

• `combined/`

Contains pre-made, curated sets of rules that combine commonly used topics (e.g., Flutter + Riverpod + Mockito). These files:

• Are kept under 6,000 characters to comply with Windsurf's limit.
• Can be used as-is by copying them into your global or local rules configuration.

✅ How To Use

Option 1: Skills - Agent Will Decide What to Use

1. 1.Browse the `skills/` folder.
2. 2.Copy or symlink skill folders into your IDE's skills directory (e.g., .cursor/skills/, .windsurf/skills/).
3. 3.The agent will automatically use relevant skills based on your task descriptions.
4. 4.You're ready to go - skills activate contextually without manual selection.

Option 2: Use Pre-Made Combined Rules

If you want a quick setup with traditional rules:

1. 1.Browse the `combined/` folder.
2. 2.Copy a file that suits your project.
3. 3.Paste it into your IDE's global or local rules config.
4. 4.You're ready to go.