How do I install the Riverpod Retry skill?

Run npx skillmds add majiayu000/riverpod-retry in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Riverpod Retry safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Riverpod Retry?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Riverpod Retry free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Riverpod Retry?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Riverpod Retry by majiayu000 — Agent Skill

Name: Riverpod Retry
Rating: 4.5 (4 reviews)
Author: majiayu000

Riverpod Retry

Customize Riverpod automatic retry on provider failure; retry function, per-provider and global retry, disabling retry, ProviderException, awaiting retries. Use when a provider can fail transiently and should retry, or when you need to disable or customize retry logic. Use this skill when the user asks about retry, failed providers, or exponential backoff in Riverpod.

majiayu000 131085f 2 files · 2.9 KB Updated Sep 9, 2026 567 repo stars

File contents

Riverpod — Automatic retry

Instructions

Riverpod retries providers when their computation throws. Retry can be customized per provider or globally.

Default behavior

By default a provider is retried up to a limit (e.g. 10 times) with exponential backoff (e.g. 200ms to 6.4s). Error and ProviderException are not retried: Error indicates a bug; ProviderException means a dependency failed, so the dependent provider is not retried (the underlying one is).

Custom retry function

A retry function has signature Duration? Function(int retryCount, Object error). Return a Duration for the delay before the next retry, or null to stop.

Duration? myRetry(int retryCount, Object error) {
  if (retryCount >= 5) return null;
  if (error is ProviderException) return null;
  return Duration(milliseconds: 200 * (1 << retryCount));
}

Where to set it

Per provider: Pass retry: myRetry when defining the provider (or @Riverpod(retry: myRetry) with codegen).
Globally: Pass retry: myRetry to ProviderScope or ProviderContainer.

// Global
ProviderScope(retry: myRetry, child: MyApp())

// Per provider (manual)
final myProvider = Provider<int>(retry: myRetry, (ref) => 0);

Disabling retry

Return null always:

ProviderScope(retry: (retryCount, error) => null, child: MyApp())

Awaiting async providers with retry

ref.watch(myProvider.future) (or equivalent) keeps waiting until either all retries are exhausted or the provider succeeds. So await ref.watch(myProvider.future) skips intermediate failures and completes when the provider finally succeeds or gives up.

---name: riverpod-retrydescription: Customize Riverpod automatic retry on provider failure; retry function, per-provider and global retry, disabling retry, ProviderException, awaiting retries. Use when a provider can fail transiently and should retry, or when you need to disable or customize retry logic. Use this skill when the user asks about retry, failed providers, or exponential backoff in Riverpod.--- # Riverpod — Automatic retry ## Instructions Riverpod **retries** providers when their computation throws. Retry can be customized per provider or globally. ### Default behavior By default a provider is retried up to a limit (e.g. 10 times) with exponential backoff (e.g. 200ms to 6.4s). **Error** and **ProviderException** are not retried: Error indicates a bug; ProviderException means a dependency failed, so the dependent provider is not retried (the underlying one is). ### Custom retry function A retry function has signature `Duration? Function(int retryCount, Object error)`. Return a **Duration** for the delay before the next retry, or **null** to stop. ```dart Duration? myRetry(int retryCount, Object error) { if (retryCount >= 5) return null; if (error is ProviderException) return null; return Duration(milliseconds: 200 * (1 << retryCount)); } ``` ### Where to set it - **Per provider:** Pass `retry: myRetry` when defining the provider (or `@Riverpod(retry: myRetry)` with codegen). - **Globally:** Pass `retry: myRetry` to **ProviderScope** or **ProviderContainer**. ```dart // Global ProviderScope(retry: myRetry, child: MyApp()) // Per provider (manual) final myProvider = Provider<int>(retry: myRetry, (ref) => 0); ``` ### Disabling retry Return **null** always: ```dart ProviderScope(retry: (retryCount, error) => null, child: MyApp()) ``` ### Awaiting async providers with retry `ref.watch(myProvider.future)` (or equivalent) keeps waiting until either all retries are exhausted or the provider succeeds. So `await ref.watch(myProvider.future)` skips intermediate failures and completes when the provider finally succeeds or gives up.

Frequently asked questions