[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7195EG3ZPJVMD599ZQXSZQ6":3,"skill-same:01M7195EG3ZPJVMD599ZQXSZQ6":52},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":21,"publishedAt":26,"linkOnly":27,"markdownContent":28,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":37,"install":38,"resources":51},"01M7195EG3ZPJVMD599ZQXSZQ6","flutter-riverpod-patterns",null,"openplaybooks-dev\u002Fconverge","openplaybooks-dev","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F270560357?v=4","01M7191G17AHW5SXN63HJ0BEZV","01M7191G29922BDNWN8CFVG4PD",3,"MIT","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fexamples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-riverpod-patterns\u002FSKILL.md",[16],{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[22,23,24,25],"flutter","patterns","riverpod","flutter riverpod patterns","2026-11-10 10:12:30",false,"# Flutter Riverpod Patterns Skill\n\nProduction patterns for state management with Riverpod 2.x in Flutter.\n\n## Provider Types\n\n### 1. Simple Provider (read-only data)\n\n```dart\n@riverpod\nList\u003CNovel> novels(Ref ref) {\n  return mockNovels;\n}\n```\n\n### 2. AsyncNotifier Provider (async data with mutations)\n\n```dart\n@riverpod\nclass NovelsNotifier extends _$NovelsNotifier {\n  @override\n  Future\u003CList\u003CNovel>> build() async {\n    return _loadNovels();\n  }\n\n  Future\u003CList\u003CNovel>> _loadNovels() async {\n    \u002F\u002F In production: API call\n    \u002F\u002F For now: return mock data\n    return mockNovels;\n  }\n\n  Future\u003Cvoid> refresh() async {\n    state = const AsyncLoading();\n    state = AsyncData(await _loadNovels());\n  }\n}\n```\n\n### 3. StateNotifier Provider (sync state with mutations)\n\n```dart\n@riverpod\nclass LibraryNotifier extends _$LibraryNotifier {\n  @override\n  LibraryState build() {\n    return LibraryState(\n      reading: [],\n      completed: [],\n      wishlist: [],\n    );\n  }\n\n  void addToReading(Novel novel) {\n    state = state.copyWith(\n      reading: [...state.reading, novel],\n    );\n  }\n\n  void moveToCompleted(String novelId) {\n    final novel = state.reading.firstWhere((n) => n.id == novelId);\n    state = state.copyWith(\n      reading: state.reading.where((n) => n.id != novelId).toList(),\n      completed: [...state.completed, novel],\n    );\n  }\n}\n```\n\n### 4. Family Provider (parameterized)\n\n```dart\n@riverpod\nFuture\u003CNovel> novelById(Ref ref, String id) async {\n  final novels = await ref.watch(novelsProvider.future);\n  return novels.firstWhere((n) => n.id == id);\n}\n```\n\n## Consuming Providers in Widgets\n\n### ConsumerWidget (stateless)\n\n```dart\nclass HomeFeedScreen extends ConsumerWidget {\n  const HomeFeedScreen({super.key});\n\n  @override\n  Widget build(BuildContext context, WidgetRef ref) {\n    final novels = ref.watch(novelsProvider);\n\n    return novels.when(\n      data: (data) => ListView.builder(\n        itemCount: data.length,\n        itemBuilder: (context, index) => NovelCard(novel: data[index]),\n      ),\n      loading: () => const Center(child: CircularProgressIndicator()),\n      error: (e, st) => Center(child: Text('Error: $e')),\n    );\n  }\n}\n```\n\n### ConsumerStatefulWidget (with local state)\n\n```dart\nclass BrowseScreen extends ConsumerStatefulWidget {\n  const BrowseScreen({super.key});\n\n  @override\n  ConsumerState\u003CBrowseScreen> createState() => _BrowseScreenState();\n}\n\nclass _BrowseScreenState extends ConsumerState\u003CBrowseScreen> {\n  String _selectedGenre = 'All';\n\n  @override\n  Widget build(BuildContext context) {\n    final novels = ref.watch(novelsProvider);\n    \u002F\u002F ... filter by _selectedGenre\n  }\n}\n```\n\n## File Organization\n\n```\nlib\u002Fproviders\u002F\n├── novels_provider.dart       # Novel list + CRUD\n├── library_provider.dart      # User's library state\n├── reader_settings_provider.dart  # Reader preferences\n├── audio_player_provider.dart     # Audio playback state\n└── providers.dart             # Barrel export\n```\n\n## Rules\n\n1. One provider file per domain entity\n2. Use `@riverpod` annotation (code-gen) over manual providers\n3. Run `dart run build_runner build` after creating\u002Fmodifying providers\n4. Export all from `lib\u002Fproviders\u002Fproviders.dart` barrel file\n5. Provider names follow pattern: `{entity}Provider`, `{entity}NotifierProvider`\n",{},"main","7d618d8bc059f1a0974706d1d15ec25f73cf1e1d","examples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-riverpod-patterns",1,"https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge","https:\u002F\u002Fplaybooks.to","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev","2026-06-13 10:11:21",{"source":7,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add openplaybooks-dev\u002Fconverge --skill flutter-riverpod-patterns",{"tool":44,"command":45},"bunx","bunx skills add openplaybooks-dev\u002Fconverge --skill flutter-riverpod-patterns",{"tool":47,"command":48},"pnpm","pnpm dlx skills add openplaybooks-dev\u002Fconverge --skill flutter-riverpod-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fexamples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-riverpod-patterns\u002FSKILL.md",true,[],[53,77,86,108,133,161],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":60,"publishedAt":26},"01M71989MQF3GPZ7P5TX6S93PD","hello-checker","Use this skill when asked to \"verify\", \"check\", or \"validate\" a file's existence and content. It provides a reliable workflow for confirming files meet their spec.","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Ftests\u002Ftest-codex-real\u002F.converge\u002Fskills\u002Fhello-checker\u002FSKILL.md",[59],{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},[61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76],"checker","hello checker","hello","it","use","content","validate","spec","verify","check","file","workflow","when","Meet","files","for",{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":83,"publishedAt":26},"01M7198823W79B3S15TPV97TCB","ask-skill","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Ftests\u002Ftest-ask-autonomous\u002F.converge\u002Fplaybooks\u002Fdefault\u002Fskills\u002Fask-skill\u002FSKILL.md",[82],{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},[84,85],"ask skill","ask",{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":96,"publishedAt":26},"01M71986EJ6VCM8YKGEM2YEDQV","html-review-artifact","Framework-wide guidance for crafting polished human-review artifacts as markdown or HTML","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fskills\u002Fhtml-review-artifact\u002FSKILL.md",[92,95],{"categoryNo":93,"categoryName":94,"taxonomyType":19,"taxonomyTypeDesc":20},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},[97,98,99,100,101,76,102,103,104,105,106,107],"html","artifact","review","html review artifact","as","framework","wide","guidance","markdown","human","artifacts",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":115,"publishedAt":26},"01M719833M2XWXG1VPBW30GW7J","converge-planning","Design a Converge playbook end-to-end. Use when the user says \"plan a project\", \"design a playbook\", \"decompose into tasks\", \"scaffold a Converge workflow\", \"onboard to Converge\", or asks how to write TASK.md \u002F playbook.yml. Two entry points: plan a new playbook or update an existing one. Hand off to `\u002Fconverge-control` after producing the playbook structure.","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fskills\u002Fconverge-planning\u002FSKILL.md",[114],{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},[116,117,118,119,72,120,65,121,122,123,124,125,126,127,128,129,130,131,132,73],"converge","converge planning","planning","structure","tasks","decompose","hand","write","plan","how","update","playbook","new","design","how to","end","project",{"skillNo":134,"name":135,"nameZh":6,"description":136,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":137,"categories":138,"keywords":145,"publishedAt":26},"01M7197XZT1T9GDYAJGVGX1J60","converge-control","Operate a Converge playbook end-to-end — start runs, monitor progress, narrow failures with `--select`, inspect runtime state, validate definitions, surgically reset subtrees, and stop stuck or orphaned runs. Use this skill whenever the user says \"run my playbook\", \"execute this\", \"monitor the run\", \"converge failed\", \"the run is stuck\", \"retry failures\", \"babysit this playbook\", \"what's the status?\", \"show me the gantt\", or asks how to use `converge run` \u002F `--select` \u002F `inspect` \u002F `doctor` \u002F `clean` \u002F `stop`. Also use it for `HTTP 401` \u002F `Invalid API key` failures on the first task — those are environment-not-playbook problems — and for any post-run cleanup work. Hand off to `converge-planning` if the user wants to design or restructure the playbook itself.","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fskills\u002Fconverge-control\u002FSKILL.md",[139,140],{"categoryNo":17,"categoryName":18,"taxonomyType":19,"taxonomyTypeDesc":20},{"categoryNo":141,"categoryName":142,"taxonomyType":143,"taxonomyTypeDesc":144},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[146,147,116,148,149,150,151,152,153,154,122,155,156,129,130,157,131,158,159,160],"converge control","control","operate","invalid","show","api","me","work","reset","show me","cleanup","clean","inspect","select","retry",{"skillNo":162,"name":163,"nameZh":6,"description":164,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":8,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":165,"categories":166,"keywords":168,"publishedAt":26},"01M7197SCVN0QTD3CM4M83WYJH","repair-taskts","Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors","https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fpackages\u002Fcore\u002Fsrc\u002Fnavigator\u002Frepair\u002Fskill-templates\u002Frepair-taskts\u002FSKILL.md",[167],{"categoryNo":141,"categoryName":142,"taxonomyType":143,"taxonomyTypeDesc":144},[169,170,171,172,123,173,174,175,176,177,178,179,180,181,182,131,183,116,184,185],"repair taskts","repair","Bash","edit","read","line","at","spawn","code","analysis","number","errors","issues","fix","chain","definition","never"]