---
name: flutter-bloc-usage
description: Explain what the `flutter-bloc` plugin does and how to use it. Use when the user invokes `/flutter-bloc-usage`, asks what this plugin covers, or needs help with Cubit/BLoC state modeling, presentation effects, or the boundary with `flutter-cubit-utils`.
---

# BLoC Usage

## How to respond

- If the user invoked this skill without a concrete task, start by explaining what this plugin covers and where its boundaries are.
- Show how to use it with concrete state-management tasks this plugin can handle.
- Point to the main rule here, or route the user to `flutter-cubit-utils` when the task is really about base cubits and canonical recipes.
- If the user already gave a concrete BLoC/Cubit task, briefly explain why this plugin fits and then do the work.
- Do not reply with filler like "skill loaded", "ready for the task", or "what would you like to do?" before explaining the plugin.

## What this plugin does

- Covers LeanCode conventions for `bloc` and `flutter_bloc`.
- Covers presentation side effects with `bloc_presentation`.
- Covers widget state-read simplifications like replacing a top-level `BlocBuilder` with `context.watch` when that refactor is safe.
- Clarifies the boundary between general BLoC guidance here and base-cubit recipes in `flutter-cubit-utils`.

## How to use it

- Ask to design or refactor cubit state for a feature.
- Ask how to model presentation events for snackbars, dialogs, or navigation side effects.
- Ask to simplify a widget tree that uses a root `BlocBuilder` only to pass through cubit state.
- Ask whether a task belongs here or in `flutter-cubit-utils`.
- Ask for a review of a cubit/widget pair against LeanCode state-management rules.

## Example requests

- "Refactor this cubit state to follow LeanCode BLoC conventions."
- "How should I model a snackbar or navigation side effect from this cubit?"
- "Does this belong in `flutter-bloc` or `flutter-cubit-utils`?"

## Reach for these assets

- `rules/state-management.md` - main BLoC/Cubit fundamentals.
- `skills/flutter-context-watch-instead-of-top-builder/SKILL.md` - focused workflow for replacing a top-level `BlocBuilder` with `context.watch`.
- Related plugin: `flutter-cubit-utils` - base classes and canonical recipes for `QueryCubit`, `PaginatedQueryCubit`, `RequestCubit`, and related cubits.
- If the task is mainly about choosing or implementing a base cubit, switch to `flutter-cubit-utils`.