LogoFlutter Edge AI

Package Skills

flutter_edge_ai ships agent skills for coding assistants — Claude Code, Codex, Cursor, Copilot and others learn the API from skills bundled in the package, installed with one dart run skills@ get --all.

A coding assistant that has never seen flutter_edge_ai writes plausible code that fails. It installs a .litertlm model without declaring its file type and lands on the wrong engine, reads maxTokens as the reply length, or leaves out isUser: true and gets an empty reply.

flutter_edge_ai ships agent skills — instruction files in the open Agent Skills format — inside the package itself. Dart's skills CLI copies them into your project, where your assistant picks them up.

Not to be confused with Agent Skills — the flutter_edge_ai_agent package, which gives the on-device model skills to run. The skills on this page teach your coding assistant to use flutter_edge_ai.

Install#

From your app's root, once flutter_edge_ai 2.0.0 or later is a dependency (the skills follow the installed version):

dart run skills@ get --all

The CLI scans your dependencies, finds the skills they bundle, and installs them for the assistant it detects in the project:

Assistant--agentInstalled to
Claude Codeclaude.claude/skills/
Codex, Antigravity codex, antigravity .agents/skills/
Cursorcursor.cursor/skills/
GitHub Copilotcopilot.github/skills/
Clinecline.cline/skills/
OpenCodeopencode.opencode/skills/
any othergeneric.agents/skills/

Detection looks for the assistant's directory in the project root. When there is none yet, the CLI asks which assistants to install for (Unable to auto-detect agent. Please select one or more); it stops with Could not auto-detect agent and none selected only without a terminal or when you select nothing. To skip the question, name the assistant with --agent (or the SKILLS_AGENT environment variable):

dart run skills@ get --all --agent claude

Copilot is never auto-detected, because .github/ serves many other purposes, so it needs --agent copilot, or picking it when the CLI asks. --all installs everything without asking; --skill <name> installs only the skills you name, and can be repeated. The CLI records what it installed in .config/dart_skills/skills_config.json.

Run the same command after upgrading flutter_edge_ai: it updates the installed skills to the ones the new version ships.

To try it end to end — install the skills, have your assistant build a chat and a tool call, and check its code against the rules — follow the Package Skills codelab.

How your assistant uses them#

Each skill is a folder with a SKILL.md: a description of when it applies, then rules, working code, and the traps that fail without an error. The assistant reads only the descriptions up front and loads a skill when a task matches — "add an offline chat with Gemma" pulls in the inference skill, "search my notes by meaning" the RAG one. In Claude Code they install as skills the model invokes on its own; there is no command to remember.

The skills#

SkillCovers
flutter-edge-ai-inference engines, installing a model from Hugging Face, sessions and chats, streaming, system prompts, images and audio, backends — and the platform setup for Android, iOS, macOS, Windows, Linux and web
flutter-edge-ai-function-calling declaring tools, FunctionCallResponse , the built-in tool loop, returning errors as results
flutter-edge-ai-rag embedding models, flutter_edge_ai_rag ( RagIndex , embedding profiles), SQLite/Qdrant providers, filters and their schema, ownership
flutter-edge-ai-decisions the experimental Decider API: picking one of N options or abstaining, calibration, tool routing for function calling, storing a fitted decider, Jev Choice JSON
flutter-edge-ai-speech Whisper, moonshine and Parakeet STT; Matcha, Qwen3 and Inflect TTS; 16 kHz PCM; VoiceSession
flutter-edge-ai-mediapipe .task and .bin models on Android, iOS and web
flutter-edge-ai-onnx ORT-GenAI generation and ONNX embeddings, native and through Transformers.js
flutter-edge-ai-builtin-ai Gemini Nano on Android and in desktop Chrome, Phi-4-mini in Edge, Apple Foundation Models on iPhone, iPad and Mac, Phi Silica on Windows; availability, falling back to a downloaded model
flutter-edge-ai-diagnostics measuring what a model costs in memory with flutter_edge_ai_diagnostics : what the OS kills on per platform, null versus MemoryReadException

What they prevent#

The skills spell out the defaults that fail quietly, each with its fix:

  • maxTokens is the context window, not the reply length — cap a reply with maxOutputTokens.
  • Message.isUser defaults to false; a prompt without it gets an empty reply.
  • The declared fileType, not the file name, picks the engine, and it defaults to .task.
  • Speech-to-text takes raw 16 kHz mono PCM. A WAV file or 48 kHz audio is not rejected — it is transcribed wrong.
  • The engine packages do not re-export core: import package:flutter_edge_ai/flutter_edge_ai.dart as well.

Kept in step with the code#

Every code block in the skills is compiled against the real packages before each release, and a release that changes an API a skill describes gets that skill re-read and updated. The skills ship inside the package, so upgrading flutter_edge_ai and re-running the CLI keeps your assistant current.