Agent skill

Flutter Pageview Scroll Position Preservation

by divinevideo in divinevideo/divine-mobile

Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds.

MPL-2.0Auto-check passedMobile

Install Flutter Pageview Scroll Position Preservation

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a claude-code

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

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation --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/flutter-pageview-implicit-scrolling-snapback .claude/skills/flutter-pageview-scroll-position-preservation && 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/

Paste into Claude Code

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .claude/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/flutter-pageview-implicit-scrolling-snapback .agents/skills/flutter-pageview-scroll-position-preservation && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .agents/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/flutter-pageview-implicit-scrolling-snapback .cursor/skills/flutter-pageview-scroll-position-preservation && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .cursor/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/divinevideo/divine-mobile.git --path .agents/skills/flutter-pageview-implicit-scrolling-snapback

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/flutter-pageview-implicit-scrolling-snapback .gemini/skills/flutter-pageview-scroll-position-preservation && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .gemini/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/flutter-pageview-implicit-scrolling-snapback .github/skills/flutter-pageview-scroll-position-preservation && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .github/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install divinevideo/divine-mobile flutter-pageview-scroll-position-preservation --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/divinevideo/divine-mobile.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/flutter-pageview-implicit-scrolling-snapback .opencode/skills/flutter-pageview-scroll-position-preservation && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "flutter-pageview-scroll-position-preservation" agent skill from https://github.com/divinevideo/divine-mobile/tree/main/.agents/skills/flutter-pageview-implicit-scrolling-snapback into .opencode/skills/flutter-pageview-scroll-position-preservation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flutter-pageview-scroll-position-preservation", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: flutter-pageview-scroll-position-preservation
GitHub stars: 266
Token cost: ~1.2k tokens
SKILL.md length: 291 words
Files: 1
Skills in repo: 103
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MPL-2.0

At a glance

Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds.

Works in 4 steps: Add PageStorageKey (PRIMARY FIX) → Keep PageController in State (not build) → Ensure keepPage is true (default) → …
PageView scrolls then snaps back to previous page after state update
SKILL.md covers Problem, Context / Trigger Conditions, Root Cause and Solution, plus 5 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter Pageview Scroll Position Preservation is an agent skill from divinevideo/divine-mobile. Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds. Use when: (1) PageView scrolls then snaps back to previous page after state update, (2) Scroll position resets when Riverpod/Provider rebuilds, (3) Feed scrolls back to top on data refresh, (4) PageView loses position after orientation change or widget rebuild.

Its SKILL.md is about 1.2k 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, covering Cross-platform mobile apps. It works with Flutter. The licence is MPL-2.0.

When your agent uses it

PageView scrolls then snaps back to previous page after state update
Scroll position resets when Riverpod/Provider rebuilds
Feed scrolls back to top on data refresh
PageView loses position after orientation change

Example prompts

“snap back”
“/flutter-pageview-scroll-position-preservation”

Workflow steps

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

Add PageStorageKey (PRIMARY FIX)
Keep PageController in State (not build)
Ensure keepPage is true (default)
For complex state: Use PageStorage widget

What it can do on your machine

Read from SKILL.md and the folder at commit 4c622be. 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):
- api.flutter.dev
- medium.com
- github.com
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 Pageview Scroll Position Preservation loads about 1.2k tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 291 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: ~1.2k

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 4c622be, republished under its MPL-2.0 licence (© divinevideo). 291 words, ~1,185 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-pageview-scroll-position-preservation/SKILL.md (or your agent's skills folder).

name: flutter-pageview-scroll-position-preservation
description: Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds. Use when: (1) PageView scrolls then snaps back to previous page after state update, (2) Scroll position resets when Riverpod/Provider rebuilds, (3) Feed scrolls back to top on data refresh, (4) PageView loses position after orientation change or widget rebuild.
author: Claude Code
version: 1.1.0
date: 2026-01-31

Flutter PageView Scroll Position Preservation

Problem

Users scrolling through a PageView-based feed report that the scroll position resets or "snaps back" to a previous page, especially after state updates from providers (Riverpod, Provider, BLoC) or widget rebuilds.

Context / Trigger Conditions

PageView with dynamic content from state management
Provider/Riverpod state updates causing widget rebuilds
Pagination that changes itemCount
Orientation changes
Tab switching and returning to the PageView

Root Cause

When Flutter rebuilds the widget tree (due to state changes), the PageView may lose its scroll position if:

No PageStorageKey is provided to persist state
The PageController is recreated during rebuilds
PageController.keepPage is set to false

Note: allowImplicitScrolling is for accessibility focus navigation, NOT scroll position preservation. A specific bug (#76569) involving TextField focus was fixed in Flutter.

Solution

1. Add PageStorageKey (PRIMARY FIX)

dart

PageView.builder(
  // This key tells Flutter to persist scroll state across rebuilds
  key: const PageStorageKey<String>('my_page_view'),
  itemCount: videos.length,
  controller: _pageController,
  ...
)

2. Keep PageController in State (not build)

dart

class _MyScreenState extends State<MyScreen> {
  // Create in initState, NOT in build()
  late PageController _pageController;

  @override
  void initState() {
    super.initState();
    _pageController = PageController();  // Created once
  }

  @override
  void dispose() {
    _pageController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    // Use the same controller instance
    return PageView.builder(
      controller: _pageController,
      ...
    );
  }
}

3. Ensure keepPage is true (default)

dart

_pageController = PageController(
  keepPage: true,  // This is the default, but be explicit if needed
  initialPage: 0,
);

dart

PageStorage(
  bucket: PageStorageBucket(),
  child: PageView.builder(
    key: const PageStorageKey<String>('feed'),
    ...
  ),
)

What allowImplicitScrolling Actually Does

This is for accessibility, not scroll position:

false (default): Accessibility focus exits PageView at page boundaries
true: Accessibility focus moves to next page instead of exiting widget

It does NOT cause scroll position issues. Keep it true for better accessibility.

Verification

Scroll to page 10+ in the feed
Trigger a state update (like new data arriving)
Verify scroll position is preserved
Rotate device - verify position preserved
Switch tabs and return - verify position preserved

Example

Full pattern for a Riverpod-based feed:

dart

class _VideoFeedScreenState extends ConsumerState<VideoFeedScreen> {
  late PageController _pageController;

  @override
  void initState() {
    super.initState();
    _pageController = PageController();
  }

  @override
  void dispose() {
    _pageController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final videos = ref.watch(videoFeedProvider);

    return PageView.builder(
      key: const PageStorageKey<String>('video_feed'),
      controller: _pageController,
      itemCount: videos.length,
      allowImplicitScrolling: true,  // For accessibility
      itemBuilder: (context, index) => VideoItem(videos[index]),
    );
  }
}

Notes

The Riverpod 3.2.0 issue #4661 about ProviderScope rebuilds is separate
If using tabs, wrap in AutomaticKeepAliveClientMixin to preserve state
For very long lists, consider using restorationId for app restart persistence

References

Files

Just SKILL.md in .agents/skills/flutter-pageview-implicit-scrolling-snapback of divinevideo/divine-mobile.

Open the folder on GitHubat commit 4c622be

Compare with similar skills

Flutter Pageview Scroll Position Preservation 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 Pageview Scroll Position Preservation compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Flutter Pageview Scroll Position Preservation this skilldivinevideo/divine-mobile	266	—	~1.2k	Automated safety check: Pass	MPL-2.0	yesterday
Add Flutter Docusaurus Localematthiasn/lotti	1.2k	—	~1.2k	Automated safety check: Pass	GPL-3.0	yesterday
Tm Launcher DesignFar-Se/tabame	372	—	~3.1k	Automated safety check: Pass	MIT	yesterday
Mobile App UI Designceorkm/mobile-app-ui-design	400	—	~2k	Automated safety check: Pass	None	3 mo ago
Marionette Flutter Drive Appleancodepl/marionette_mcp	473	—	~11k	Automated safety check: Pass	Apache-2.0	3 days ago
Flutter ScreenshotJustLookAtNow/pt_mate	503	—	~511	Automated safety check: Pass	MIT	3 days ago

Similar skills

Add Flutter Docusaurus Locale
matthiasn/lotti
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 yesterday
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 yesterday
MobileAuto-check passed
Mobile App UI Design
ceorkm/mobile-app-ui-design
Design high-quality mobile app UI/UX screens, flows, and components.
400 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.
473 GitHub stars~11k tokensUpdated 3 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 3 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

Questions about Flutter Pageview Scroll Position Preservation

What does Flutter Pageview Scroll Position Preservation do?

Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds. Flutter Pageview Scroll Position Preservation is an agent skill from divinevideo/divine-mobile. Fix Flutter PageView "snap back" or scroll position reset issues on provider/state rebuilds.

When should I use Flutter Pageview Scroll Position Preservation?

Flutter Pageview Scroll Position Preservation fits situations like: pageView scrolls then snaps back to previous page after state update; scroll position resets when Riverpod/Provider rebuilds; feed scrolls back to top on data refresh; pageView loses position after orientation change.

How do I install Flutter Pageview Scroll Position Preservation in Claude Code?

Run `npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a claude-code`. Or copy the skill folder (.agents/skills/flutter-pageview-implicit-scrolling-snapback in divinevideo/divine-mobile) into .claude/skills/flutter-pageview-scroll-position-preservation in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Pageview Scroll Position Preservation in Codex?

Run `npx skills add divinevideo/divine-mobile --skill flutter-pageview-scroll-position-preservation -a codex`. Or copy the skill folder (.agents/skills/flutter-pageview-implicit-scrolling-snapback in divinevideo/divine-mobile) into .agents/skills/flutter-pageview-scroll-position-preservation in your project. Codex loads it when a task matches its description.

Can I use Flutter Pageview Scroll Position Preservation 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 flutter-pageview-scroll-position-preservation -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-pageview-scroll-position-preservation, .gemini/skills/flutter-pageview-scroll-position-preservation, .github/skills/flutter-pageview-scroll-position-preservation and .opencode/skills/flutter-pageview-scroll-position-preservation in your project.

What does Flutter Pageview Scroll Position Preservation need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter Pageview Scroll Position Preservation is instructions for the agent only.

Does Flutter Pageview Scroll Position Preservation access the network?

SKILL.md names 3 domains. As links in the text: api.flutter.dev, medium.com and github.com. This is read from the text; nothing was executed.

Is Flutter Pageview Scroll Position Preservation 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 Flutter Pageview Scroll Position Preservation use?

Flutter Pageview Scroll Position Preservation 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 Flutter Pageview Scroll Position Preservation use?

About 1.2k tokens (SKILL.md is roughly 4.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 Flutter Pageview Scroll Position Preservation?

Skills that share tags, products or a category with Flutter Pageview Scroll Position Preservation: Add Flutter Docusaurus Locale (matthiasn/lotti, 1.2k stars), Tm Launcher Design (Far-Se/tabame, 372 stars), Mobile App UI Design (ceorkm/mobile-app-ui-design, 400 stars) and Marionette Flutter Drive App (leancodepl/marionette_mcp, 473 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Pageview Scroll Position Preservation?

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 8, 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.

Install Flutter Pageview Scroll Position Preservation

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Flutter PageView Scroll Position Preservation

Problem

Context / Trigger Conditions

Root Cause

Solution

1. Add PageStorageKey (PRIMARY FIX)

2. Keep PageController in State (not build)

3. Ensure keepPage is true (default)

4. For complex state: Use PageStorage widget

What allowImplicitScrolling Actually Does

Verification

Example

Notes

References

Files

Compare with similar skills

Similar skills

More from divinevideo/divine-mobile

Related

Questions about Flutter Pageview Scroll Position Preservation