Agent skill

Riverpod Ref Read In Dispose

by divinevideo in divinevideo/divine-mobile

Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget.

MPL-2.0Auto-check passedMobile

Install Riverpod Ref Read In Dispose

skills CLI
$ npx skills add divinevideo/divine-mobile --skill riverpod-ref-read-in-dispose -a claude-code

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

GitHub CLI
$ gh skill install divinevideo/divine-mobile riverpod-ref-read-in-dispose --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/divinevideo/divine-mobile.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/riverpod-ref-read-in-dispose .claude/skills/riverpod-ref-read-in-dispose && 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
riverpod-ref-read-in-dispose
GitHub stars
266
Token cost
~928 tokens
SKILL.md length
246 words
Files
1
Skills in repo
103
Repo updated
First seen
Licence
MPL-2.0

At a glance

Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget.

  • Works in 3 steps: Add a late final field for the service → Initialize in initState → Use cached reference in dispose
  • Error thrown in dispose() when calling ref.read()
  • SKILL.md covers Problem, Context / Trigger Conditions, Solution and Verification, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Riverpod Ref Read In Dispose is an agent skill from divinevideo/divine-mobile. Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget. Use when: (1) Error thrown in dispose() when calling ref.read(), (2) Need to call a service method during widget cleanup, (3) ConsumerStatefulWidget needs to perform actions on provider when user navigates away. Solution: cache the service/notifier in initState with late final.

Its SKILL.md is about 930 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. It works with Flutter. The licence is MPL-2.0.

When your agent uses it

  • Error thrown in dispose() when calling ref.read()
  • Need to call a service method during widget cleanup
  • ConsumerStatefulWidget needs to perform actions on provider when user navigates away

Example prompts

  • “Using ref when widget is unmounted is unsafe”
  • “/riverpod-ref-read-in-dispose”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Add a late final field for the service
  2. Initialize in initState
  3. Use cached reference in dispose

What it can do on your machine

Read from SKILL.md and the folder at commit 6487b05. 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):

    • riverpod.dev
    • api.flutter.dev

    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

Riverpod Ref Read In Dispose loads about 928 tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 246 words of instructions outside code blocks.

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

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 divinevideo/divine-mobile at commit 6487b05, republished under its MPL-2.0 licence (© divinevideo). 246 words, ~928 tokens.

Download SKILL.mdSave it as .claude/skills/riverpod-ref-read-in-dispose/SKILL.md (or your agent's skills folder).
name
riverpod-ref-read-in-dispose
description
Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget. Use when: (1) Error thrown in dispose() when calling ref.read(), (2) Need to call a service method during widget cleanup, (3) ConsumerStatefulWidget needs to perform actions on provider when user navigates away. Solution: cache the service/notifier in initState with late final.
author
Claude Code
version
1.0.0
date
2026-02-01

Riverpod ref.read() in dispose() Error

Problem

When a ConsumerStatefulWidget needs to call a service method in dispose() (e.g., to cancel an operation when the user leaves a screen), using ref.read() throws an error because the widget is already unmounted.

Context / Trigger Conditions

  • Error message: Using ref when widget is unmounted is unsafe
  • Using ConsumerStatefulWidget with ConsumerState
  • Calling ref.read(someProvider) inside dispose()
  • Widget navigates away (pop, push replacement, etc.)
  • Stack trace shows the error originating from dispose()

Example problematic code:

dart
@override
void dispose() {
  ref.read(authServiceProvider).cancelOperation();  // ERROR!
  super.dispose();
}

Solution

Step 1: Add a late final field for the service
dart
class _MyScreenState extends ConsumerState<MyScreen> {
  late final MyService _myService;  // Cache here
Step 2: Initialize in initState
dart
@override
void initState() {
  super.initState();
  _myService = ref.read(myServiceProvider);  // Safe here
}
Step 3: Use cached reference in dispose
dart
@override
void dispose() {
  _myService.cancelOperation();  // Use cached reference
  super.dispose();
}

Verification

  1. Navigate to the screen
  2. Navigate away (back button, push replacement, etc.)
  3. No "Using ref when widget is unmounted" error in console
  4. The cleanup action (cancel, close, etc.) still executes

Example

Before (causes error):
dart
class _NostrConnectScreenState extends ConsumerState<NostrConnectScreen> {
  @override
  void dispose() {
    // ERROR: ref is not safe to use here
    ref.read(authServiceProvider).cancelNostrConnect();
    super.dispose();
  }
}
After (works correctly):
dart
class _NostrConnectScreenState extends ConsumerState<NostrConnectScreen> {
  // Cache AuthService for use in dispose (can't use ref.read in dispose)
  late final AuthService _authService;

  @override
  void initState() {
    super.initState();
    _authService = ref.read(authServiceProvider);
  }

  @override
  void dispose() {
    // Cancel the session if user leaves the screen
    _authService.cancelNostrConnect();
    super.dispose();
  }
}

Notes

  • This pattern is necessary because Riverpod's ref is tied to the widget lifecycle
  • ref.read() is safe in initState() because the widget is being mounted
  • ref.read() is NOT safe in dispose() because the widget is being unmounted
  • The late final pattern ensures the service is initialized exactly once
  • This applies to any cleanup that requires calling methods on providers
  • For simple provider state changes (not method calls), consider using deactivate() instead
  • If the service itself might be disposed, add null checks or try-catch as appropriate
  • flutter-dispose-timer-test-failure: For timer-related dispose issues
  • flutter-deactivate-setstate-during-build: For setState/build cycle issues in deactivate

References

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

Files

Just SKILL.md in .agents/skills/riverpod-ref-read-in-dispose of divinevideo/divine-mobile.

Open the folder on GitHubat commit 6487b05

Compare with similar skills

Riverpod Ref Read In Dispose 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.

Riverpod Ref Read In Dispose compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Riverpod Ref Read In Dispose this skilldivinevideo/divine-mobile266—~928Automated safety check: PassMPL-2.0
Add Flutter Docusaurus Localematthiasn/lotti1.2k—~1.2kAutomated safety check: PassGPL-3.0
Tm Launcher DesignFar-Se/tabame372—~3.1kAutomated safety check: PassMIT
Flutter Initbear2u/my-skills933—~2.5kAutomated safety check: PassNone
Mobile App UI Designceorkm/mobile-app-ui-design403—~2kAutomated safety check: PassNone
Marionette Flutter Drive Appleancodepl/marionette_mcp482—~11kAutomated safety check: PassApache-2.0

Similar skills

  • 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.

    372 GitHub stars~3.1k 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
  • Mobile App UI Design

    ceorkm/mobile-app-ui-design

    Design high-quality mobile app UI/UX screens, flows, and components.

    403 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.

    482 GitHub stars~11k tokensUpdated 4 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 4 days ago
    MobileAuto-check passed

More from divinevideo/divine-mobile

All 103 skills in this repo
  • Fix ArgoCD ExternalSecret deployment failing with "namespace X is not permitted in project Y".

    266 GitHub stars~931 tokensUpdated today
    Auto-check passed
  • Art Direct

    divinevideo/divine-mobile

    Art direction for any content — reads text, PDF, Word, HTML, PPT, then proposes 2-3 creative directions with photography style, mood, and visual language.

    266 GitHub stars~4.8k tokensUpdated today
    Auto-check passed
  • Async Await Null Race Condition

    divinevideo/divine-mobile

    Fix "Null check operator used on a null value" errors when an object is set to null during an async await.

    266 GitHub stars~881 tokensUpdated today
    Auto-check passed
  • AWS V4 Signing Custom Headers Gcs

    divinevideo/divine-mobile

    Add custom metadata headers (x-amz-meta-) to AWS v4 signed requests for GCS S3-compatible API.

    266 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Bash Herestring Newline Secrets

    divinevideo/divine-mobile

    Fix password/secret authentication failures caused by trailing newlines when creating Google Cloud secrets (or similar) with bash here-strings.

    266 GitHub stars~791 tokensUpdated today
    Auto-check passed
  • Fix silent video/media processing failures caused by URL extraction code that filters on file extensions (.mp4, .webm, .webp).

    266 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Riverpod Ref Read In Dispose

What does Riverpod Ref Read In Dispose do?

Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget. Riverpod Ref Read In Dispose is an agent skill from divinevideo/divine-mobile. Fix Riverpod "Using ref when widget is unmounted is unsafe" error in ConsumerStatefulWidget.

When should I use Riverpod Ref Read In Dispose?

Riverpod Ref Read In Dispose fits situations like: error thrown in dispose() when calling ref.read(); need to call a service method during widget cleanup; consumerStatefulWidget needs to perform actions on provider when user navigates away.

How do I install Riverpod Ref Read In Dispose in Claude Code?

Run `npx skills add divinevideo/divine-mobile --skill riverpod-ref-read-in-dispose -a claude-code`. Or copy the skill folder (.agents/skills/riverpod-ref-read-in-dispose in divinevideo/divine-mobile) into .claude/skills/riverpod-ref-read-in-dispose in your project. Claude Code loads it when a task matches its description.

How do I install Riverpod Ref Read In Dispose in Codex?

Run `npx skills add divinevideo/divine-mobile --skill riverpod-ref-read-in-dispose -a codex`. Or copy the skill folder (.agents/skills/riverpod-ref-read-in-dispose in divinevideo/divine-mobile) into .agents/skills/riverpod-ref-read-in-dispose in your project. Codex loads it when a task matches its description.

Can I use Riverpod Ref Read In Dispose 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 divinevideo/divine-mobile --skill riverpod-ref-read-in-dispose -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/riverpod-ref-read-in-dispose, .gemini/skills/riverpod-ref-read-in-dispose, .github/skills/riverpod-ref-read-in-dispose and .opencode/skills/riverpod-ref-read-in-dispose in your project.

What does Riverpod Ref Read In Dispose need to run?

SKILL.md names no scripts, command-line tools or credentials: Riverpod Ref Read In Dispose is instructions for the agent only.

Does Riverpod Ref Read In Dispose access the network?

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

Is Riverpod Ref Read In Dispose 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 Riverpod Ref Read In Dispose use?

Riverpod Ref Read In Dispose is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Riverpod Ref Read In Dispose use?

About 928 tokens (SKILL.md is roughly 3.7k 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 Riverpod Ref Read In Dispose?

Skills that share tags, products or a category with Riverpod Ref Read In Dispose: Add Flutter Docusaurus Locale (matthiasn/lotti, 1.2k stars), Tm Launcher Design (Far-Se/tabame, 372 stars), Flutter Init (bear2u/my-skills, 933 stars) and Mobile App UI Design (ceorkm/mobile-app-ui-design, 403 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Riverpod Ref Read In Dispose?

divinevideo (a GitHub organization) maintains it in divinevideo/divine-mobile, which has 266 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 9, 2026.

Source: divinevideo/divine-mobile on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.