[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7194XC90MJT430AS5YYW76M":3,"skill-same:01M7194XC90MJT430AS5YYW76M":64},{"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":37,"linkOnly":38,"markdownContent":39,"markdownBody":40,"frontMatter":41,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":47,"ownerHtmlUrl":48,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":49,"install":50,"resources":63},"01M7194XC90MJT430AS5YYW76M","flutter-building-forms",null,"Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.","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-building-forms\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],"flutter building forms","flutter","forms","use","when","with","multi","input handling","login","entry","validation","data","input","user","2026-11-10 10:12:30",false,"---\nname: flutter-building-forms\ndescription: Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.\n---\n# Building Validated Forms\n\n## Contents\n- [Form Architecture](#form-architecture)\n- [Field Validation](#field-validation)\n- [Workflow: Implementing a Validated Form](#workflow-implementing-a-validated-form)\n- [Examples](#examples)\n\n## Form Architecture\n\nImplement forms using a `Form` widget to group and validate multiple input fields together.\n\n- **Use a StatefulWidget:** Always host your `Form` inside a `StatefulWidget`.\n- **Persist the GlobalKey:** Instantiate a `GlobalKey\u003CFormState>` exactly once as a final variable within the `State` class. Do not generate a new `GlobalKey` inside the `build` method.\n- **Bind the Key:** Pass the `GlobalKey\u003CFormState>` to the `key` property of the `Form` widget.\n- **Alternative Access:** Use `Form.of(context)` to access the `FormState` from a descendant widget.\n\n## Field Validation\n\nUse `TextFormField` for Material Design text inputs with built-in validation.\n\n- **Implement the Validator:** Provide a `validator()` callback to each `TextFormField`.\n- **Return Error Messages:** If invalid, return a `String` with the error message.\n- **Return Null for Success:** If valid, return `null`.\n\n## Workflow: Implementing a Validated Form\n\n- [ ] Create a `StatefulWidget` and its `State` class.\n- [ ] Instantiate `final _formKey = GlobalKey\u003CFormState>();` in the `State` class.\n- [ ] Return a `Form` widget in `build` and assign `key: _formKey`.\n- [ ] Add `TextFormField` widgets as descendants of the `Form`.\n- [ ] Write a `validator` function for each field (return `String` on error, `null` on success).\n- [ ] Add a submit button.\n- [ ] Validate in `onPressed` using `_formKey.currentState!.validate()`.\n\n### Validation Decision Logic\n\n1. Call `_formKey.currentState!.validate()`.\n2. **If `true`:** Proceed with submission (save data, API call) and show success (`SnackBar`).\n3. **If `false`:** Error messages display automatically. User adjusts input and resubmits.\n\n## Examples\n\n### Complete Validated Form\n\n```dart\nclass UserRegistrationForm extends StatefulWidget {\n  const UserRegistrationForm({super.key});\n\n  @override\n  State\u003CUserRegistrationForm> createState() => _UserRegistrationFormState();\n}\n\nclass _UserRegistrationFormState extends State\u003CUserRegistrationForm> {\n  final _formKey = GlobalKey\u003CFormState>();\n\n  @override\n  Widget build(BuildContext context) {\n    return Form(\n      key: _formKey,\n      child: Column(\n        crossAxisAlignment: CrossAxisAlignment.start,\n        children: [\n          TextFormField(\n            decoration: const InputDecoration(\n              labelText: 'Username',\n              hintText: 'Enter your username',\n            ),\n            validator: (value) {\n              if (value == null || value.isEmpty) {\n                return 'Please enter a username';\n              }\n              if (value.length \u003C 4) {\n                return 'Username must be at least 4 characters';\n              }\n              return null;\n            },\n          ),\n          const SizedBox(height: 16),\n          ElevatedButton(\n            onPressed: () {\n              if (_formKey.currentState!.validate()) {\n                ScaffoldMessenger.of(context).showSnackBar(\n                  const SnackBar(content: Text('Processing Data')),\n                );\n              }\n            },\n            child: const Text('Submit'),\n          ),\n        ],\n      ),\n    );\n  }\n}\n```\n","# Building Validated Forms\n\n## Contents\n- [Form Architecture](#form-architecture)\n- [Field Validation](#field-validation)\n- [Workflow: Implementing a Validated Form](#workflow-implementing-a-validated-form)\n- [Examples](#examples)\n\n## Form Architecture\n\nImplement forms using a `Form` widget to group and validate multiple input fields together.\n\n- **Use a StatefulWidget:** Always host your `Form` inside a `StatefulWidget`.\n- **Persist the GlobalKey:** Instantiate a `GlobalKey\u003CFormState>` exactly once as a final variable within the `State` class. Do not generate a new `GlobalKey` inside the `build` method.\n- **Bind the Key:** Pass the `GlobalKey\u003CFormState>` to the `key` property of the `Form` widget.\n- **Alternative Access:** Use `Form.of(context)` to access the `FormState` from a descendant widget.\n\n## Field Validation\n\nUse `TextFormField` for Material Design text inputs with built-in validation.\n\n- **Implement the Validator:** Provide a `validator()` callback to each `TextFormField`.\n- **Return Error Messages:** If invalid, return a `String` with the error message.\n- **Return Null for Success:** If valid, return `null`.\n\n## Workflow: Implementing a Validated Form\n\n- [ ] Create a `StatefulWidget` and its `State` class.\n- [ ] Instantiate `final _formKey = GlobalKey\u003CFormState>();` in the `State` class.\n- [ ] Return a `Form` widget in `build` and assign `key: _formKey`.\n- [ ] Add `TextFormField` widgets as descendants of the `Form`.\n- [ ] Write a `validator` function for each field (return `String` on error, `null` on success).\n- [ ] Add a submit button.\n- [ ] Validate in `onPressed` using `_formKey.currentState!.validate()`.\n\n### Validation Decision Logic\n\n1. Call `_formKey.currentState!.validate()`.\n2. **If `true`:** Proceed with submission (save data, API call) and show success (`SnackBar`).\n3. **If `false`:** Error messages display automatically. User adjusts input and resubmits.\n\n## Examples\n\n### Complete Validated Form\n\n```dart\nclass UserRegistrationForm extends StatefulWidget {\n  const UserRegistrationForm({super.key});\n\n  @override\n  State\u003CUserRegistrationForm> createState() => _UserRegistrationFormState();\n}\n\nclass _UserRegistrationFormState extends State\u003CUserRegistrationForm> {\n  final _formKey = GlobalKey\u003CFormState>();\n\n  @override\n  Widget build(BuildContext context) {\n    return Form(\n      key: _formKey,\n      child: Column(\n        crossAxisAlignment: CrossAxisAlignment.start,\n        children: [\n          TextFormField(\n            decoration: const InputDecoration(\n              labelText: 'Username',\n              hintText: 'Enter your username',\n            ),\n            validator: (value) {\n              if (value == null || value.isEmpty) {\n                return 'Please enter a username';\n              }\n              if (value.length \u003C 4) {\n                return 'Username must be at least 4 characters';\n              }\n              return null;\n            },\n          ),\n          const SizedBox(height: 16),\n          ElevatedButton(\n            onPressed: () {\n              if (_formKey.currentState!.validate()) {\n                ScaffoldMessenger.of(context).showSnackBar(\n                  const SnackBar(content: Text('Processing Data')),\n                );\n              }\n            },\n            child: const Text('Submit'),\n          ),\n        ],\n      ),\n    );\n  }\n}\n```\n",{"name":5,"description":7},"main","7d618d8bc059f1a0974706d1d15ec25f73cf1e1d","examples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-building-forms",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":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add openplaybooks-dev\u002Fconverge --skill flutter-building-forms",{"tool":56,"command":57},"bunx","bunx skills add openplaybooks-dev\u002Fconverge --skill flutter-building-forms",{"tool":59,"command":60},"pnpm","pnpm dlx skills add openplaybooks-dev\u002Fconverge --skill flutter-building-forms","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fopenplaybooks-dev\u002Fconverge\u002Fblob\u002Fmain\u002Fexamples\u002Fflutter-app\u002F.converge\u002Fskills\u002Fflutter-building-forms\u002FSKILL.md",true,[],[65,87,96,118,143,171],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":72,"publishedAt":37},"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",[71],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[73,74,75,76,26,77,78,79,80,81,82,83,27,84,85,86],"checker","hello checker","hello","it","content","validate","spec","verify","check","file","workflow","Meet","files","for",{"skillNo":88,"name":89,"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":90,"categories":91,"keywords":93,"publishedAt":37},"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",[92],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[94,95],"ask skill","ask",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":106,"publishedAt":37},"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",[102,105],{"categoryNo":103,"categoryName":104,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[107,108,109,110,111,86,112,113,114,115,116,117],"html","artifact","review","html review artifact","as","framework","wide","guidance","markdown","human","artifacts",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":125,"publishedAt":37},"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",[124],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[126,127,128,129,83,130,26,131,132,133,134,135,136,137,138,139,140,141,142,27],"converge","converge planning","planning","structure","tasks","decompose","hand","write","plan","how","update","playbook","new","design","how to","end","project",{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":155,"publishedAt":37},"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",[149,150],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":151,"categoryName":152,"taxonomyType":153,"taxonomyTypeDesc":154},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[156,157,126,158,159,160,161,162,163,164,132,165,166,139,140,167,141,168,169,170],"converge control","control","operate","invalid","show","api","me","work","reset","show me","cleanup","clean","inspect","select","retry",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":178,"publishedAt":37},"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",[177],{"categoryNo":151,"categoryName":152,"taxonomyType":153,"taxonomyTypeDesc":154},[179,180,181,182,133,183,184,185,186,187,188,189,190,191,192,141,193,126,194,195],"repair taskts","repair","Bash","edit","read","line","at","spawn","code","analysis","number","errors","issues","fix","chain","definition","never"]