Agent skill

Flutter Networking

by MADTeacher in MADTeacher/mad-agents-skills

Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing…

MITAuto-check passedMobile

Install Flutter Networking

skills CLI
$ npx skills add MADTeacher/mad-agents-skills --skill flutter-networking -a claude-code

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

GitHub CLI
$ gh skill install MADTeacher/mad-agents-skills flutter-networking --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/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/flutter-networking .claude/skills/flutter-networking && 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/

Facts

Skill name
flutter-networking
GitHub stars
110
Token cost
~1.8k tokens
SKILL.md length
807 words
Files
14 (incl. scripts, references, assets)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing…

  • Works in 6 steps: Confirm the target is a Flutter or Dart… → Preserve the project's current client… → For implementation tasks, prefer small… → …
  • Asked to add network requests
  • SKILL.md covers Core Contract, Clarification Rules, Resource Routing and Networking Defaults, plus 1 more section
  • Runs Dart and Shell scripts from its folder; calls flutter and dart

What it does

Flutter Networking is an agent skill from MADTeacher/mad-agents-skills. Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing, caching, background isolates, repositories, services, and adaptation to existing http, Dio, Retrofit, Chopper, or custom API clients. Use when asked to add network requests, investigate network errors, harden API clients, handle auth, or validate Flutter network behavior.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts, reference files and assets (for example `references/authentication.md`, `references/error-handling.md` and `references/http-basics.md`).

It sits in Mobile, covering Cross-platform mobile apps and Realtime and WebSockets. It works with Flutter and Dart. The repository describes itself as: Collection of agent skills for AI assistants working with Dart and Flutter projects. The licence is MIT.

When your agent uses it

  • Asked to add network requests
  • Investigate network errors
  • Harden API clients
  • Validate Flutter network behavior

Example prompts

  • “/flutter-networking”

Requirements

  • A Bash shell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the target is a Flutter or Dart package by inspecting pubspec.yaml,
  2. Preserve the project's current client stack unless there is no networking
  3. For implementation tasks, prefer small injectable clients/services with
  4. For review and debugging tasks, report broken status handling, leaked
  5. Keep UI networking thin. Widgets may trigger commands or observe state, but
  6. Validate with the repo's normal commands. Prefer flutter analyze, focused

What it can do on your machine

Read from SKILL.md and the folder at commit 2fb67e3. 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

    Ships 1 file in scripts/ (Dart and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • flutter
    • dart

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 Networking loads about 1.8k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 122 tokens; SKILL.md has 807 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~122
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from MADTeacher/mad-agents-skills at commit 2fb67e3, republished under its MIT licence (© MADTeacher). 807 words, ~1,774 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-networking/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
flutter-networking
description
Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing, caching, background isolates, repositories, services, and adaptation to existing http, Dio, Retrofit, Chopper, or custom API clients. Use when asked to add network requests, investigate network errors, harden API clients, handle auth, or validate Flutter network behavior.
metadata.author
Stanislav [MADTeacher] Chernyshev
metadata.version
2.0

Flutter Networking

You are a networking agent for Flutter apps. Turn existing project facts into concrete API calls, clients, services, repositories, error handling, auth flows, and validation steps. Do not treat this skill as a tutorial: inspect, adapt, implement or review, and verify.

Core Contract

  1. Confirm the target is a Flutter or Dart package by inspecting pubspec.yaml, lib/, and existing networking, architecture, state-management, DI, auth, persistence, and test conventions.
  2. Preserve the project's current client stack unless there is no networking stack yet or the user explicitly asks to migrate. Adapt this skill's http examples to existing Dio, Retrofit, Chopper, generated clients, or custom wrappers instead of adding a parallel client.
  3. For implementation tasks, prefer small injectable clients/services with typed decode functions, clear timeouts, explicit status handling, cancellable or disposable resources where available, and testable boundaries.
  4. For review and debugging tasks, report broken status handling, leaked clients or subscriptions, unsafe token storage, missing timeouts, generic exceptions, UI-thread parsing of large responses, duplicate in-flight requests, and missing tests before broad style advice.
  5. Keep UI networking thin. Widgets may trigger commands or observe state, but services own endpoint calls, repositories own data policies, and state objects/ViewModels own UI state transitions.
  6. Validate with the repo's normal commands. Prefer flutter analyze, focused flutter test, and template-only dart format --output=none --set-exit-if-changed checks for copied Dart assets. Explain skipped checks.

Clarification Rules

Ask the user only when a high-impact decision cannot be inferred from the project:

  • API contract, endpoint base URL, auth mechanism, or token lifecycle is absent;
  • realtime behavior needs product semantics such as reconnect policy, ordering, delivery guarantees, or offline behavior;
  • cache freshness, optimistic updates, pagination, or retry policy would change user-visible data correctness;
  • the project already has multiple networking stacks and the intended target is ambiguous.

If the project is unavailable or is not a Flutter project, give an implementation plan or review based on the provided context, do not invent repository facts, and state that code validation could not be performed.

Resource Routing

Read only the references and assets needed for the current task:

NeedReadUse for
Basic HTTP CRUD or JSON modelshttp-basics.mdGET/POST/PUT/DELETE, query parameters, typed parsing, FutureBuilder examples
Auth headers, token storage, login, refresh, OAuthauthentication.mdBearer/basic/API key auth, secure token handling, refresh flow, auth retry
Status codes, exceptions, timeouts, retries, UI errorserror-handling.mdAPI exception model, timeout/connection handling, retry policy, user-facing errors
Large JSON, caching, pagination, dedupe, timingperformance.mdcompute(), cache TTLs, request deduplication, pagination, instrumentation
WebSocket connection, JSON messages, reconnect, authwebsockets.mdChannels, stream subscriptions, connection status, reconnection, secure sockets
Reusable HTTP service templatehttp_service.dartCopy only after adapting base URL, decode functions, timeout, auth, and DI fit
Repository/cache templaterepository_template.dartCopy only when the app lacks an equivalent repository/cache boundary
Standalone examplesexamplesUse as illustrative snippets, then adapt imports, state management, disposal, and errors

Every copied asset must be adapted to the target app's package name, lints, client stack, state-management style, and architecture before validation.

Show full SKILL.md (311 more words)Show less

Networking Defaults

  • Use http: ^1.6.0 and web_socket_channel: ^3.0.3 only for new simple clients. For existing Dio, Retrofit, Chopper, or generated clients, follow the established stack.
  • Inject clients instead of constructing them deep inside services. Close owned http.Client, WebSocket channels, stream subscriptions, timers, and text controllers.
  • Treat 200..299 as success only when the endpoint contract allows it. Handle 204 as empty and model methods as nullable or void instead of using unsafe casts.
  • Decode JSON into typed models at service/repository boundaries. Use background isolates for large responses, but avoid isolate overhead for small payloads.
  • Add request timeouts and retry only transient failures. Do not retry unsafe mutations unless the API is idempotent or the user confirms the product policy.
  • Store sensitive tokens with flutter_secure_storage: ^10.0.0 or the app's existing secure storage. Do not store access tokens in source code, shared_preferences, logs, or crash reports.
  • Use wss:// for WebSockets. Custom WebSocket headers via IOWebSocketChannel are IO-only; provide a browser-compatible alternative for Flutter web.
  • Do not manually set Accept-Encoding as a default with package:http; let the platform/client negotiate compression unless the project has a measured need.

Validation

Before finishing an implementation or review:

  1. Check that endpoint calls are behind testable services or repositories and that UI code does not own raw HTTP/WebSocket details.
  2. Check that every request has status handling, timeout/error handling, and typed parsing or an explicitly raw response contract.
  3. Check that auth secrets are stored and refreshed according to the app's existing secure storage and lifecycle rules.
  4. Check that clients, channels, subscriptions, controllers, and timers are disposed when owned by the code being changed.
  5. Run the closest available validation:
    • flutter analyze
    • focused flutter test suites for changed network/auth/repository code
    • dart format --output=none --set-exit-if-changed for copied Dart assets
    • this skill's scripts/verify-examples.sh when changing bundled examples or templates
  6. Report commands run, failures, skipped checks, and residual networking risks.

© MADTeacher, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (scripts, references, assets) in flutter-networking of MADTeacher/mad-agents-skills.

  • SKILL.md
  • assets/code-templates/http_service.dart
  • assets/code-templates/repository_template.dart
  • assets/examples/auth_example.dart
  • assets/examples/background_parsing.dart
  • assets/examples/fetch_example.dart
  • assets/examples/post_example.dart
  • assets/examples/websocket_example.dart
  • references/authentication.md
  • references/error-handling.md
  • references/http-basics.md
  • references/performance.md
  • references/websockets.md
  • scripts/verify-examples.sh

Open the folder on GitHubat commit 2fb67e3

Compare with similar skills

Flutter Networking 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 Networking compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Networking this skillMADTeacher/mad-agents-skills110—~1.8kAutomated safety check: PassMIT
Layered ArchitectureVeryGoodOpenSource/vgv-ai-flutter-plugin169—~4.6kAutomated safety check: PassMIT
Flutter Startup Network Blockingdivinevideo/divine-mobile266—~1.2kAutomated safety check: PassMPL-2.0
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Flutter Cherry Pickflutter/flutter179k—~1.8kAutomated safety check: PassBSD-3-Clause
Upgrade Browserflutter/flutter179k—~1.1kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Layered Architecture

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    VGV layered monorepo architecture in Flutter: four layers Data, Repository, Business Logic, and Presentation, unidirectional dependency rules, and model transformation across layers.

    169 GitHub stars~4.6k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Flutter Startup Network Blocking

    divinevideo/divine-mobile

    Fix slow Flutter app startup caused by blocking network operations during initialization.

    266 GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Flutter Cherry Pick

    flutter/flutter

    How to land a formal cherry-pick of a merged PR for the flutter/flutter repo stable or beta channel.

    179k GitHub stars~1.8k tokensUpdated today
    MobileAuto-check passed
  • Upgrade Browser

    flutter/flutter

    Upgrade browser versions (Chrome or Firefox) in the Flutter Web Engine and/or Framework tests.

    179k GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed
  • Bump Dart

    flutter/flutter

    Do not trigger automatically; only run when a user runs /bump-dart.

    179k GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed

More from MADTeacher/mad-agents-skills

All 11 skills in this repo
  • Flutter Internationalization

    MADTeacher/mad-agents-skills

    Add, fix, audit, and maintain Flutter internationalization with gen-l10n, ARB files, AppLocalizations, flutterlocalizations, intl formatting, plural/select messages, RTL support, locale-specific…

    110 GitHub stars~1.7k tokensUpdated 5 mo ago
    Auto-check passed
  • Agents Md Generator

    MADTeacher/mad-agents-skills

    Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure.

    110 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Dart Drift

    MADTeacher/mad-agents-skills

    Build, fix, audit, and migrate Drift persistence in Dart CLI, server-side, and non-Flutter desktop apps.

    110 GitHub stars~1.2k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Duit Bdui

    MADTeacher/mad-agents-skills

    Integrate, fix, review, migrate, test, or debug Duit / flutterduit backend-driven UI in Flutter applications.

    110 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Testing

    MADTeacher/mad-agents-skills

    Write, fix, review, debug, and validate Flutter tests for apps, packages, and plugins.

    110 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Adaptive UI

    MADTeacher/mad-agents-skills

    Build, fix, review, and validate adaptive or responsive Flutter UIs for mobile, tablet, desktop, web, large screens, foldables, and mixed input devices.

    110 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Flutter Networking

What does Flutter Networking do?

Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing…. Flutter Networking is an agent skill from MADTeacher/mad-agents-skills. Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing, caching, background isolates, repositories, services, and adaptation to existing http, Dio, Retrofit, Chopper, or custom API clients.

When should I use Flutter Networking?

Flutter Networking fits situations like: asked to add network requests; investigate network errors; harden API clients; validate Flutter network behavior.

How do I install Flutter Networking in Claude Code?

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

How do I install Flutter Networking in Codex?

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

Can I use Flutter Networking 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 MADTeacher/mad-agents-skills --skill flutter-networking -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-networking, .gemini/skills/flutter-networking, .github/skills/flutter-networking and .opencode/skills/flutter-networking in your project.

What does Flutter Networking need to run?

Going by SKILL.md and its folder, Flutter Networking needs Dart and a shell for the scripts in its folder and the command-line tools its instructions call (flutter and dart). Our summary lists: A Bash shell.

Does Flutter Networking access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter Networking 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Flutter Networking use?

Flutter Networking is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Networking use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Flutter Networking?

Skills that share tags, products or a category with Flutter Networking: Layered Architecture (VeryGoodOpenSource/vgv-ai-flutter-plugin, 169 stars), Flutter Startup Network Blocking (divinevideo/divine-mobile, 266 stars), Engine Whats New (flutter/flutter, 179k stars) and Flutter Cherry Pick (flutter/flutter, 179k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Networking?

MADTeacher (a GitHub user) maintains it in MADTeacher/mad-agents-skills, which has 110 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on May 1, 2026.

Source: MADTeacher/mad-agents-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.