FlutterSDK AI

Name: FlutterSDK Docs
Author: fluttersdk

AI coding skills for the FlutterSDK ecosystem.
Teach your AI assistant Wind UI, Magic Framework, and more, across every major coding tool.

Registry · Issues · Quick Start

Why?

AI coding assistants are powerful, but they don't know your frameworks. They hallucinate widget names, guess at API patterns, and miss conventions.

FlutterSDK AI fixes this. It gives your AI structured knowledge about Wind UI's className system, Magic Framework's Laravel-inspired architecture, and more, so it generates correct code on the first try.

One install, every tool:

Tool	Integration
OpenCode	URL-based skill registry
Claude Code	Plugin + Marketplace
Cursor	Rules (`.mdc`)
Gemini CLI	Command templates (`.toml`)
VS Code Copilot	Instructions (`.md`)
Codex CLI	MCP config (`~/.codex/config.toml`)
Antigravity CLI	MCP config (`~/.gemini/config/mcp_config.json`)
Cline	MCP config (`.mcp.json`)
Roo Code	MCP config (`.mcp.json`)

Skills

Five skills are available. See docs/SKILLS.md for full descriptions.

Skill	Package	Upstream	What it covers
`wind-ui`	`fluttersdk_wind`	fluttersdk/wind	W-prefix widgets, the `className` parser pipeline, `WindRecipe` variants, dark mode, responsive breakpoints, design culture
`magic-framework`	`magic`	fluttersdk/magic	IoC container, 18 facades, Eloquent ORM, GoRouter routing, forms, auth, testing, 5 ecosystem plugins
`fluttersdk-dusk`	`fluttersdk_dusk`	fluttersdk/dusk	E2E driver: `dusk_*` MCP tools and matching CLI commands to snap, tap, type, and screenshot a running Flutter app
`fluttersdk-telescope`	`fluttersdk_telescope`	fluttersdk/telescope	Runtime inspector: 9 ring buffers for HTTP, logs, exceptions, events, gates, DB queries
`fluttersdk-artisan`	`fluttersdk_artisan`	fluttersdk/artisan	CLI framework + stdio MCP server: substrate `artisan_*` tools, builtin commands, `artisan_tinker`

Each skill mirrors its upstream package's own skills/ directory and arrives here when that package publishes a release. The exact synced version is the version: field in skills/<name>/SKILL.md, and skills/index.json is the machine-readable index; neither is duplicated in this table, so neither can drift from it.

MCP Server

mcp.fluttersdk.com exposes a single search-docs tool via Streamable HTTP. Public, no auth required. Full client config snippets (Claude Code, Cursor, OpenCode, Codex CLI, Gemini CLI, VS Code Copilot, and more) are in docs/MCP.md.

For clients that only support stdio (Claude Desktop, older Codex CLI):

bash

npx @fluttersdk/mcp

The npx bridge proxies stdio to the upstream HTTP server transparently.

Quick Start

Option 1: `npx skills` (Recommended)

The fastest way. Works with 40+ AI coding agents.

bash

# Install all FlutterSDK skills to all detected agents
npx skills add fluttersdk/ai

# Install a specific skill
npx skills add fluttersdk/ai --skill wind-ui

# Install globally (available across all projects)
npx skills add fluttersdk/ai -g

Option 2: Universal Installer

bash

git clone https://github.com/fluttersdk/ai.git && cd ai

# Preview what would be installed
bash scripts/install.sh --dry-run --global

# Install globally for all detected tools
bash scripts/install.sh --global

# Install globally and register the MCP server for all detected tools
bash scripts/install.sh --global --with-mcp

# Or install into your current Flutter project
bash scripts/install.sh --project

Option 3: Tool-Specific

OpenCode

Add the registry URL to your opencode.json:

json

{
    "skills": {
        "urls": ["https://fluttersdk.github.io/ai/"]
    }
}

Skills are fetched automatically and cached locally.

Claude Code

bash

/plugin marketplace add https://raw.githubusercontent.com/fluttersdk/ai/main/.claude-plugin/marketplace.json
/plugin install fluttersdk@fluttersdk-marketplace

The plugin auto-registers:

5 skills (/fluttersdk:wind-ui, /fluttersdk:magic-framework, /fluttersdk:fluttersdk-dusk, /fluttersdk:fluttersdk-telescope, /fluttersdk:fluttersdk-artisan)
/fluttersdk:flutter-review, a review that runs in a subagent as an independent second pair of eyes and then fixes what it finds, plus /fluttersdk:flutter-test
fluttersdk:flutter-reviewer and fluttersdk:flutter-reviewer-deep subagents, invokable directly with @
fluttersdk MCP server (HTTP transport to mcp.fluttersdk.com; no manual .mcp.json edit required)

Cursor

bash

mkdir -p .cursor/rules
cp tool-templates/cursor/fluttersdk.mdc .cursor/rules/

Activates automatically for all .dart files.

Gemini CLI

bash

mkdir -p ~/.gemini/commands
cp tool-templates/gemini/*.toml ~/.gemini/commands/

Use with /flutter-review and /flutter-test commands.

VS Code Copilot

bash

mkdir -p .github
cp .github/copilot-instructions.md .github/

How It Works

skills/index.json              ← OpenCode fetches this from GitHub Pages
  → wind-ui/SKILL.md           ← Skill definition + className rules
  → wind-ui/references/*.md    ← On-demand widget docs, layout patterns, tokens
  → magic-framework/SKILL.md   ← Skill definition + framework laws
  → magic-framework/refs/*.md  ← Controllers, ORM, facades, routing, auth, ...

OpenCode: Fetches fluttersdk.github.io/ai/index.json, downloads listed skill files, caches locally.

Claude Code: Plugin manifest (.claude-plugin/plugin.json) makes the repo installable. Skills in skills/ are auto-discovered and namespaced under /fluttersdk:.

Deployment: Push to main → GitHub Actions deploys skills/ to GitHub Pages automatically.

Contributing

Adding a New Skill

Create skills/<skill-name>/SKILL.md with YAML frontmatter (name, description)
Add reference files in skills/<skill-name>/references/
Update skills/index.json: list every file in the files array
Bump version in .claude-plugin/plugin.json and .claude-plugin/marketplace.json
Push to main