[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7195376TMTFDR3EHB7MG1SP":3,"skill-same:01M7195376TMTFDR3EHB7MG1SP":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":40,"linkOnly":41,"markdownContent":42,"markdownBody":43,"frontMatter":44,"refName":45,"commitSha":46,"skillDirectory":47,"forksCount":48,"repositoryHtmlUrl":49,"repositoryHomepageUrl":50,"ownerHtmlUrl":51,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":52,"install":53,"resources":66},"01M7195376TMTFDR3EHB7MG1SP","flutter-handling-http-and-json",null,"Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.","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-handling-http-and-json\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"flutter","json","flutter handling http and json","http","structured","serialization","flutter app","data","requests","REST","with","when","use","structured data","parsing","sources","app","2026-11-10 10:12:30",false,"---\nname: flutter-handling-http-and-json\ndescription: Executes HTTP requests and handles JSON serialization in a Flutter app. Use when integrating with REST APIs or parsing structured data from external sources.\n---\n# Handling HTTP and JSON\n\n## Contents\n- [Core Guidelines](#core-guidelines)\n- [Workflow: Executing HTTP Operations](#workflow-executing-http-operations)\n- [Workflow: Implementing JSON Serialization](#workflow-implementing-json-serialization)\n- [Examples](#examples)\n\n## Core Guidelines\n\n- **Enforce HTTPS:** iOS and Android disable cleartext (HTTP) connections by default. Always use HTTPS endpoints.\n- **Construct URIs Safely:** Always use `Uri.https(authority, unencodedPath, [queryParameters])` to build URLs safely.\n- **Handle Status Codes:** Always validate `http.Response.statusCode`. Treat `200` and `201` as success. Throw explicit exceptions for other codes.\n- **Prevent UI Jank:** Move expensive JSON parsing (>16ms) to a background isolate using `compute()`.\n\n## Workflow: Executing HTTP Operations\n\n- [ ] Add the `http` package to `pubspec.yaml`.\n- [ ] Configure platform permissions (Internet permission in `AndroidManifest.xml`).\n- [ ] Construct the target `Uri`.\n- [ ] Execute the HTTP method (`http.get`, `http.post`, `http.put`, `http.delete`).\n- [ ] Validate the response and parse JSON payload.\n\n## Workflow: Implementing JSON Serialization\n\n**Small prototype \u002F simple models:** Use manual serialization with `dart:convert`.\n- [ ] Define Model class with `final` properties.\n- [ ] Implement `factory Model.fromJson(Map\u003CString, dynamic> json)`.\n- [ ] Implement `Map\u003CString, dynamic> toJson()`.\n\n**Production app \u002F complex models:** Use code generation with `json_serializable` or `freezed`.\n- [ ] Add `json_annotation` and `json_serializable` (or `freezed`) dependencies.\n- [ ] Add `part 'model_name.g.dart';` directive.\n- [ ] Annotate class with `@JsonSerializable()` or `@freezed`.\n- [ ] Run `dart run build_runner build --delete-conflicting-outputs`.\n\n## Examples\n\n### HTTP GET with Manual Serialization\n\n```dart\nimport 'dart:convert';\nimport 'package:http\u002Fhttp.dart' as http;\n\nclass Album {\n  final int id;\n  final String title;\n\n  const Album({required this.id, required this.title});\n\n  factory Album.fromJson(Map\u003CString, dynamic> json) {\n    return Album(\n      id: json['id'] as int,\n      title: json['title'] as String,\n    );\n  }\n}\n\nFuture\u003CAlbum> fetchAlbum() async {\n  final uri = Uri.https('jsonplaceholder.typicode.com', '\u002Falbums\u002F1');\n  final response = await http.get(uri);\n\n  if (response.statusCode == 200) {\n    return Album.fromJson(jsonDecode(response.body) as Map\u003CString, dynamic>);\n  } else {\n    throw Exception('Failed to load album');\n  }\n}\n```\n\n### Background Parsing with `compute`\n\n```dart\nimport 'dart:convert';\nimport 'package:flutter\u002Ffoundation.dart';\nimport 'package:http\u002Fhttp.dart' as http;\n\nList\u003CPhoto> parsePhotos(String responseBody) {\n  final parsed = (jsonDecode(responseBody) as List).cast\u003CMap\u003CString, Object?>>();\n  return parsed.map\u003CPhoto>(Photo.fromJson).toList();\n}\n\nFuture\u003CList\u003CPhoto>> fetchPhotos(http.Client client) async {\n  final uri = Uri.https('jsonplaceholder.typicode.com', '\u002Fphotos');\n  final response = await client.get(uri);\n\n  if (response.statusCode == 200) {\n    return compute(parsePhotos, response.body);\n  } else {\n    throw Exception('Failed to load photos');\n  }\n}\n```\n","# Handling HTTP and JSON\n\n## Contents\n- [Core Guidelines](#core-guidelines)\n- [Workflow: Executing HTTP Operations](#workflow-executing-http-operations)\n- [Workflow: Implementing JSON Serialization](#workflow-implementing-json-serialization)\n- [Examples](#examples)\n\n## Core Guidelines\n\n- **Enforce HTTPS:** iOS and Android disable cleartext (HTTP) connections by default. Always use HTTPS endpoints.\n- **Construct URIs Safely:** Always use `Uri.https(authority, unencodedPath, [queryParameters])` to build URLs safely.\n- **Handle Status Codes:** Always validate `http.Response.statusCode`. Treat `200` and `201` as success. Throw explicit exceptions for other codes.\n- **Prevent UI Jank:** Move expensive JSON parsing (>16ms) to a background isolate using `compute()`.\n\n## Workflow: Executing HTTP Operations\n\n- [ ] Add the `http` package to `pubspec.yaml`.\n- [ ] Configure platform permissions (Internet permission in `AndroidManifest.xml`).\n- [ ] Construct the target `Uri`.\n- [ ] Execute the HTTP method (`http.get`, `http.post`, `http.put`, `http.delete`).\n- [ ] Validate the response and parse JSON payload.\n\n## Workflow: Implementing JSON Serialization\n\n**Small prototype \u002F simple models:** Use manual serialization with `dart:convert`.\n- [ ] Define Model class with `final` properties.\n- [ ] Implement `factory Model.fromJson(Map\u003CString, dynamic> json)`.\n- [ ] Implement `Map\u003CString, dynamic> toJson()`.\n\n**Production app \u002F complex models:** Use code generation with `json_serializable` or `freezed`.\n- [ ] Add `json_annotation` and `json_serializable` (or `freezed`) dependencies.\n- [ ] Add `part 'model_name.g.dart';` directive.\n- [ ] Annotate class with `@JsonSerializable()` or `@freezed`.\n- [ ] Run `dart run build_runner build --delete-conflicting-outputs`.\n\n## Examples\n\n### HTTP GET with Manual Serialization\n\n```dart\nimport 'dart:convert';\nimport 'package:http\u002Fhttp.dart' as http;\n\nclass Album {\n  final int id;\n  final String title;\n\n  const Album({required this.id, required this.title});\n\n  factory Album.fromJson(Map\u003CString, dynamic> json) {\n    return Album(\n      id: json['id'] as int,\n      title: json['title'] as String,\n    );\n  }\n}\n\nFuture\u003CAlbum> fetchAlbum() async {\n  final uri = Uri.https('jsonplaceholder.typicode.com', '\u002Falbums\u002F1');\n  final response = await http.get(uri);\n\n  if (response.statusCode == 200) {\n    return Album.fromJson(jsonDecode(response.body) as Map\u003CString, dynamic>);\n  } else {\n    throw Exception('Failed to load album');\n  }\n}\n```\n\n### Background Parsing with `compute`\n\n```dart\nimport 'dart:convert';\nimport 'package:flutter\u002Ffoundation.dart';\nimport 'package:http\u002Fhttp.dart' as http;\n\nList\u003CPhoto> parsePhotos(String responseBody) {\n  final parsed = (jsonDecode(responseBody) as List).cast\u003CMap\u003CString, Object?>>();\n  return parsed.map\u003CPhoto>(Photo.fromJson).toList();\n}\n\nFuture\u003CList\u003CPhoto>> fetchPhotos(http.Client client) async {\n  final uri = Uri.https('jsonplaceholder.typicode.com', '\u002Fphotos');\n  final response = await client.get(uri);\n\n  if (response.statusCode == 200) {\n    return compute(parsePhotos, response.body);\n  } else {\n    throw Exception('Failed to load photos');\n  }\n}\n```\n",{"name":5,"description":7},"main","7d618d8bc059f1a0974706d1d15ec25f73cf1e1d","examples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-handling-http-and-json",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":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add openplaybooks-dev\u002Fconverge --skill flutter-handling-http-and-json",{"tool":59,"command":60},"bunx","bunx skills add openplaybooks-dev\u002Fconverge --skill flutter-handling-http-and-json",{"tool":62,"command":63},"pnpm","pnpm dlx skills add openplaybooks-dev\u002Fconverge --skill flutter-handling-http-and-json","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fexamples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-handling-http-and-json\u002FSKILL.md",true,[],[68,90,99,121,146,174],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":75,"publishedAt":40},"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",[74],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[76,77,78,79,35,80,81,82,83,84,85,86,34,87,88,89],"checker","hello checker","hello","it","content","validate","spec","verify","check","file","workflow","Meet","files","for",{"skillNo":91,"name":92,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":96,"publishedAt":40},"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",[95],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[97,98],"ask skill","ask",{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":109,"publishedAt":40},"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",[105,108],{"categoryNo":106,"categoryName":107,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[110,111,112,113,114,89,115,116,117,118,119,120],"html","artifact","review","html review artifact","as","framework","wide","guidance","markdown","human","artifacts",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":128,"publishedAt":40},"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",[127],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[129,130,131,132,86,133,35,134,135,136,137,138,139,140,141,142,143,144,145,34],"converge","converge planning","planning","structure","tasks","decompose","hand","write","plan","how","update","playbook","new","design","how to","end","project",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":158,"publishedAt":40},"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",[152,153],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":154,"categoryName":155,"taxonomyType":156,"taxonomyTypeDesc":157},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[159,160,129,161,162,163,164,165,166,167,135,168,169,142,143,170,144,171,172,173],"converge control","control","operate","invalid","show","api","me","work","reset","show me","cleanup","clean","inspect","select","retry",{"skillNo":175,"name":176,"nameZh":6,"description":177,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":178,"categories":179,"keywords":181,"publishedAt":40},"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",[180],{"categoryNo":154,"categoryName":155,"taxonomyType":156,"taxonomyTypeDesc":157},[182,183,184,185,136,186,187,188,189,190,191,192,193,194,195,144,196,129,197,198],"repair taskts","repair","Bash","edit","read","line","at","spawn","code","analysis","number","errors","issues","fix","chain","definition","never"]