[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M753SJAV81YGPCSFZ95DTBP3":3,"skill-same:01M753SJAV81YGPCSFZ95DTBP3":228},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M753SJAV81YGPCSFZ95DTBP3","zod",null,"Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).","haryelramalho\u002Fskills","haryelramalho","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F38708454?v=4","01M753ESC6XNS6GXGV5X9YMKGA","Haryel Ramalho","01M753ESCSPRNDTEJRVRYY1VJ0",0,"MIT","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: zod\ndescription: Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).\n---\n\n# Zod Best Practices\n\nComprehensive schema validation guide for Zod in TypeScript applications. Contains 43 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.\n\n## When to Apply\n\nReference these guidelines when:\n\n- Writing new Zod schemas\n- Choosing between parse() and safeParse()\n- Implementing type inference with z.infer\n- Handling validation errors for user feedback\n- Composing complex object schemas\n- Using refinements and transforms\n- Optimizing bundle size and validation performance\n- Reviewing Zod code for best practices\n\n## Rule Categories by Priority\n\n| Priority | Category                 | Impact      | Prefix     |\n| -------- | ------------------------ | ----------- | ---------- |\n| 1        | Schema Definition        | CRITICAL    | `schema-`  |\n| 2        | Parsing & Validation     | CRITICAL    | `parse-`   |\n| 3        | Type Inference           | HIGH        | `type-`    |\n| 4        | Error Handling           | HIGH        | `error-`   |\n| 5        | Object Schemas           | MEDIUM-HIGH | `object-`  |\n| 6        | Schema Composition       | MEDIUM      | `compose-` |\n| 7        | Refinements & Transforms | MEDIUM      | `refine-`  |\n| 8        | Performance & Bundle     | LOW-MEDIUM  | `perf-`    |\n\n## Quick Reference\n\n### 1. Schema Definition (CRITICAL)\n\n- `schema-use-primitives-correctly` - Use correct primitive schemas for each type\n- `schema-use-unknown-not-any` - Use z.unknown() instead of z.any() for type safety\n- `schema-avoid-optional-abuse` - Avoid overusing optional fields\n- `schema-string-validations` - Apply string validations at schema definition\n- `schema-use-enums` - Use enums for fixed string values\n- `schema-coercion-for-form-data` - Use coercion for form and query data\n\n### 2. Parsing & Validation (CRITICAL)\n\n- `parse-use-safeparse` - Use safeParse() for user input\n- `parse-async-for-async-refinements` - Use parseAsync for async refinements\n- `parse-handle-all-issues` - Handle all validation issues not just first\n- `parse-validate-early` - Validate at system boundaries\n- `parse-avoid-double-validation` - Avoid validating same data twice\n- `parse-never-trust-json` - Never trust JSON.parse output\n\n### 3. Type Inference (HIGH)\n\n- `type-use-z-infer` - Use z.infer instead of manual types\n- `type-input-vs-output` - Distinguish z.input from z.infer for transforms\n- `type-export-schemas-and-types` - Export both schemas and inferred types\n- `type-branded-types` - Use branded types for domain safety\n- `type-enable-strict-mode` - Enable TypeScript strict mode\n\n### 4. Error Handling (HIGH)\n\n- `error-custom-messages` - Provide custom error messages\n- `error-use-flatten` - Use flatten() for form error display\n- `error-path-for-nested` - Use issue.path for nested error location\n- `error-i18n` - Implement internationalized error messages\n- `error-avoid-throwing-in-refine` - Return false instead of throwing in refine\n\n### 5. Object Schemas (MEDIUM-HIGH)\n\n- `object-strict-vs-strip` - Choose strict() vs strip() for unknown keys\n- `object-partial-for-updates` - Use partial() for update schemas\n- `object-pick-omit` - Use pick() and omit() for schema variants\n- `object-extend-for-composition` - Use extend() for adding fields\n- `object-optional-vs-nullable` - Distinguish optional() from nullable()\n- `object-discriminated-unions` - Use discriminated unions for type narrowing\n\n### 6. Schema Composition (MEDIUM)\n\n- `compose-shared-schemas` - Extract shared schemas into reusable modules\n- `compose-intersection` - Use intersection() for type combinations\n- `compose-lazy-recursive` - Use z.lazy() for recursive schemas\n- `compose-preprocess` - Use preprocess() for data normalization\n- `compose-pipe` - Use pipe() for multi-stage validation\n\n### 7. Refinements & Transforms (MEDIUM)\n\n- `refine-vs-superrefine` - Choose refine() vs superRefine() correctly\n- `refine-transform-coerce` - Distinguish transform() from refine() and coerce()\n- `refine-add-path` - Add path to refinement errors\n- `refine-defaults` - Use default() for optional fields with defaults\n- `refine-catch` - Use catch() for fault-tolerant parsing\n\n### 8. Performance & Bundle (LOW-MEDIUM)\n\n- `perf-cache-schemas` - Cache schema instances\n- `perf-zod-mini` - Use Zod Mini for bundle-sensitive applications\n- `perf-avoid-dynamic-creation` - Avoid dynamic schema creation in hot paths\n- `perf-lazy-loading` - Lazy load large schemas\n- `perf-arrays` - Optimize large array validation\n\n## How to Use\n\nRead individual reference files for detailed explanations and code examples:\n\n- [Section definitions](references\u002F_sections.md) - Category structure and impact levels\n- [Rule template](assets\u002Ftemplates\u002F_template.md) - Template for adding new rules\n- Individual rules: `references\u002F{prefix}-{slug}.md`\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n\n## Related Skills\n\n- For React Hook Form integration, see `react-hook-form` skill\n- For API client generation, see `orval` skill\n\n## Sources\n\n- [Zod Official Documentation](https:\u002F\u002Fzod.dev\u002F)\n- [Zod v4 Release Notes](https:\u002F\u002Fzod.dev\u002Fv4)\n- [Zod GitHub Repository](https:\u002F\u002Fgithub.com\u002Fcolinhacks\u002Fzod)\n- [Zod Mini](https:\u002F\u002Fzod.dev\u002Fpackages\u002Fmini)\n- [Total TypeScript Zod Tutorial](https:\u002F\u002Fwww.totaltypescript.com\u002Ftutorials\u002Fzod)\n","# Zod Best Practices\n\nComprehensive schema validation guide for Zod in TypeScript applications. Contains 43 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.\n\n## When to Apply\n\nReference these guidelines when:\n\n- Writing new Zod schemas\n- Choosing between parse() and safeParse()\n- Implementing type inference with z.infer\n- Handling validation errors for user feedback\n- Composing complex object schemas\n- Using refinements and transforms\n- Optimizing bundle size and validation performance\n- Reviewing Zod code for best practices\n\n## Rule Categories by Priority\n\n| Priority | Category                 | Impact      | Prefix     |\n| -------- | ------------------------ | ----------- | ---------- |\n| 1        | Schema Definition        | CRITICAL    | `schema-`  |\n| 2        | Parsing & Validation     | CRITICAL    | `parse-`   |\n| 3        | Type Inference           | HIGH        | `type-`    |\n| 4        | Error Handling           | HIGH        | `error-`   |\n| 5        | Object Schemas           | MEDIUM-HIGH | `object-`  |\n| 6        | Schema Composition       | MEDIUM      | `compose-` |\n| 7        | Refinements & Transforms | MEDIUM      | `refine-`  |\n| 8        | Performance & Bundle     | LOW-MEDIUM  | `perf-`    |\n\n## Quick Reference\n\n### 1. Schema Definition (CRITICAL)\n\n- `schema-use-primitives-correctly` - Use correct primitive schemas for each type\n- `schema-use-unknown-not-any` - Use z.unknown() instead of z.any() for type safety\n- `schema-avoid-optional-abuse` - Avoid overusing optional fields\n- `schema-string-validations` - Apply string validations at schema definition\n- `schema-use-enums` - Use enums for fixed string values\n- `schema-coercion-for-form-data` - Use coercion for form and query data\n\n### 2. Parsing & Validation (CRITICAL)\n\n- `parse-use-safeparse` - Use safeParse() for user input\n- `parse-async-for-async-refinements` - Use parseAsync for async refinements\n- `parse-handle-all-issues` - Handle all validation issues not just first\n- `parse-validate-early` - Validate at system boundaries\n- `parse-avoid-double-validation` - Avoid validating same data twice\n- `parse-never-trust-json` - Never trust JSON.parse output\n\n### 3. Type Inference (HIGH)\n\n- `type-use-z-infer` - Use z.infer instead of manual types\n- `type-input-vs-output` - Distinguish z.input from z.infer for transforms\n- `type-export-schemas-and-types` - Export both schemas and inferred types\n- `type-branded-types` - Use branded types for domain safety\n- `type-enable-strict-mode` - Enable TypeScript strict mode\n\n### 4. Error Handling (HIGH)\n\n- `error-custom-messages` - Provide custom error messages\n- `error-use-flatten` - Use flatten() for form error display\n- `error-path-for-nested` - Use issue.path for nested error location\n- `error-i18n` - Implement internationalized error messages\n- `error-avoid-throwing-in-refine` - Return false instead of throwing in refine\n\n### 5. Object Schemas (MEDIUM-HIGH)\n\n- `object-strict-vs-strip` - Choose strict() vs strip() for unknown keys\n- `object-partial-for-updates` - Use partial() for update schemas\n- `object-pick-omit` - Use pick() and omit() for schema variants\n- `object-extend-for-composition` - Use extend() for adding fields\n- `object-optional-vs-nullable` - Distinguish optional() from nullable()\n- `object-discriminated-unions` - Use discriminated unions for type narrowing\n\n### 6. Schema Composition (MEDIUM)\n\n- `compose-shared-schemas` - Extract shared schemas into reusable modules\n- `compose-intersection` - Use intersection() for type combinations\n- `compose-lazy-recursive` - Use z.lazy() for recursive schemas\n- `compose-preprocess` - Use preprocess() for data normalization\n- `compose-pipe` - Use pipe() for multi-stage validation\n\n### 7. Refinements & Transforms (MEDIUM)\n\n- `refine-vs-superrefine` - Choose refine() vs superRefine() correctly\n- `refine-transform-coerce` - Distinguish transform() from refine() and coerce()\n- `refine-add-path` - Add path to refinement errors\n- `refine-defaults` - Use default() for optional fields with defaults\n- `refine-catch` - Use catch() for fault-tolerant parsing\n\n### 8. Performance & Bundle (LOW-MEDIUM)\n\n- `perf-cache-schemas` - Cache schema instances\n- `perf-zod-mini` - Use Zod Mini for bundle-sensitive applications\n- `perf-avoid-dynamic-creation` - Avoid dynamic schema creation in hot paths\n- `perf-lazy-loading` - Lazy load large schemas\n- `perf-arrays` - Optimize large array validation\n\n## How to Use\n\nRead individual reference files for detailed explanations and code examples:\n\n- [Section definitions](references\u002F_sections.md) - Category structure and impact levels\n- [Rule template](assets\u002Ftemplates\u002F_template.md) - Template for adding new rules\n- Individual rules: `references\u002F{prefix}-{slug}.md`\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n\n## Related Skills\n\n- For React Hook Form integration, see `react-hook-form` skill\n- For API client generation, see `orval` skill\n\n## Sources\n\n- [Zod Official Documentation](https:\u002F\u002Fzod.dev\u002F)\n- [Zod v4 Release Notes](https:\u002F\u002Fzod.dev\u002Fv4)\n- [Zod GitHub Repository](https:\u002F\u002Fgithub.com\u002Fcolinhacks\u002Fzod)\n- [Zod Mini](https:\u002F\u002Fzod.dev\u002Fpackages\u002Fmini)\n- [Total TypeScript Zod Tutorial](https:\u002F\u002Fwww.totaltypescript.com\u002Ftutorials\u002Fzod)\n",{"name":5,"description":7},"main","a5b533be2d244bbf3e5606e851742f0e0ba99423","skills\u002Fcommunity\u002Fzod","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills","https:\u002F\u002Fgithub.com\u002Fharyelramalho","linkedin.com\u002Fin\u002Fharyelramalho\u002F","Software Engineer @ SKORR •  Former Vice President of the Junior Computer Association - TecnoJr","2026-07-16 01:34:58",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add haryelramalho\u002Fskills --skill zod",{"tool":38,"command":39},"bunx","bunx skills add haryelramalho\u002Fskills --skill zod",{"tool":41,"command":42},"pnpm","pnpm dlx skills add haryelramalho\u002Fskills --skill zod","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002FSKILL.md",true,[46,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"AGENTS.md","REFERENCE","参考文档",11811,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002FAGENTS.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"README.md",3303,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002FREADME.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fcompose-intersection.md",3478,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fcompose-intersection.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fcompose-lazy-recursive.md",3290,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fcompose-lazy-recursive.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fcompose-pipe.md",3399,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fcompose-pipe.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fcompose-preprocess.md",3680,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fcompose-preprocess.md",{"path":73,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fcompose-shared-schemas.md",3380,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fcompose-shared-schemas.md",{"path":77,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Ferror-avoid-throwing-in-refine.md",3508,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ferror-avoid-throwing-in-refine.md",{"path":81,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Ferror-custom-messages.md",3603,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ferror-custom-messages.md",{"path":85,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Ferror-i18n.md",3993,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ferror-i18n.md",{"path":89,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Ferror-path-for-nested.md",3727,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ferror-path-for-nested.md",{"path":93,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Ferror-use-flatten.md",3342,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ferror-use-flatten.md",{"path":97,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Fobject-discriminated-unions.md",4028,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-discriminated-unions.md",{"path":101,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":102,"sourceHtmlUrl":103},"references\u002Fobject-extend-for-composition.md",3448,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-extend-for-composition.md",{"path":105,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002Fobject-optional-vs-nullable.md",3713,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-optional-vs-nullable.md",{"path":109,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":110,"sourceHtmlUrl":111},"references\u002Fobject-partial-for-updates.md",3580,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-partial-for-updates.md",{"path":113,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":114,"sourceHtmlUrl":115},"references\u002Fobject-pick-omit.md",3882,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-pick-omit.md",{"path":117,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":118,"sourceHtmlUrl":119},"references\u002Fobject-strict-vs-strip.md",3258,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fobject-strict-vs-strip.md",{"path":121,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":122,"sourceHtmlUrl":123},"references\u002Fparse-async-for-async-refinements.md",3209,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-async-for-async-refinements.md",{"path":125,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":126,"sourceHtmlUrl":127},"references\u002Fparse-avoid-double-validation.md",3387,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-avoid-double-validation.md",{"path":129,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":130,"sourceHtmlUrl":131},"references\u002Fparse-handle-all-issues.md",3373,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-handle-all-issues.md",{"path":133,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":134,"sourceHtmlUrl":135},"references\u002Fparse-never-trust-json.md",3174,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-never-trust-json.md",{"path":137,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":138,"sourceHtmlUrl":139},"references\u002Fparse-use-safeparse.md",2800,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-use-safeparse.md",{"path":141,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":142,"sourceHtmlUrl":143},"references\u002Fparse-validate-early.md",3412,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fparse-validate-early.md",{"path":145,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":146,"sourceHtmlUrl":147},"references\u002Fperf-arrays.md",4038,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fperf-arrays.md",{"path":149,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":150,"sourceHtmlUrl":151},"references\u002Fperf-avoid-dynamic-creation.md",3298,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fperf-avoid-dynamic-creation.md",{"path":153,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":154,"sourceHtmlUrl":155},"references\u002Fperf-cache-schemas.md",3166,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fperf-cache-schemas.md",{"path":157,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":158,"sourceHtmlUrl":159},"references\u002Fperf-lazy-loading.md",3555,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fperf-lazy-loading.md",{"path":161,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":162,"sourceHtmlUrl":163},"references\u002Fperf-zod-mini.md",3170,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fperf-zod-mini.md",{"path":165,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":166,"sourceHtmlUrl":167},"references\u002Frefine-add-path.md",3918,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Frefine-add-path.md",{"path":169,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":170,"sourceHtmlUrl":171},"references\u002Frefine-catch.md",3736,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Frefine-catch.md",{"path":173,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":174,"sourceHtmlUrl":175},"references\u002Frefine-defaults.md",3665,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Frefine-defaults.md",{"path":177,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":178,"sourceHtmlUrl":179},"references\u002Frefine-transform-coerce.md",3538,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Frefine-transform-coerce.md",{"path":181,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":182,"sourceHtmlUrl":183},"references\u002Frefine-vs-superrefine.md",4308,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Frefine-vs-superrefine.md",{"path":185,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":186,"sourceHtmlUrl":187},"references\u002Fschema-avoid-optional-abuse.md",2661,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-avoid-optional-abuse.md",{"path":189,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":190,"sourceHtmlUrl":191},"references\u002Fschema-coercion-for-form-data.md",2991,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-coercion-for-form-data.md",{"path":193,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":194,"sourceHtmlUrl":195},"references\u002Fschema-string-validations.md",2745,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-string-validations.md",{"path":197,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":198,"sourceHtmlUrl":199},"references\u002Fschema-use-enums.md",2742,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-use-enums.md",{"path":201,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":202,"sourceHtmlUrl":203},"references\u002Fschema-use-primitives-correctly.md",2107,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-use-primitives-correctly.md",{"path":205,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":206,"sourceHtmlUrl":207},"references\u002Fschema-use-unknown-not-any.md",2222,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Fschema-use-unknown-not-any.md",{"path":209,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":210,"sourceHtmlUrl":211},"references\u002Ftype-branded-types.md",3213,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ftype-branded-types.md",{"path":213,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":214,"sourceHtmlUrl":215},"references\u002Ftype-enable-strict-mode.md",2988,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ftype-enable-strict-mode.md",{"path":217,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":218,"sourceHtmlUrl":219},"references\u002Ftype-export-schemas-and-types.md",3081,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ftype-export-schemas-and-types.md",{"path":221,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":222,"sourceHtmlUrl":223},"references\u002Ftype-input-vs-output.md",3238,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ftype-input-vs-output.md",{"path":225,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":226,"sourceHtmlUrl":227},"references\u002Ftype-use-z-infer.md",3050,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcommunity\u002Fzod\u002Freferences\u002Ftype-use-z-infer.md",[229,236,243,250,257,264],{"skillNo":230,"name":231,"nameZh":6,"description":232,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":233,"categories":234,"keywords":235,"publishedAt":19},"01M753YDMKSDB7320THEQ2CVW5","to-prompt-opus","Use when preparing or rewriting prompts for Claude Opus 4.8, Anthropic API agents, XML-structured prompts, long-context document work, coding agents, research synthesis, frontend\u002Fdesign tasks, or model-specific prompt optimization. Do not use for GPT\u002FOpenAI prompts or raw context packaging without Opus-specific tuning.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fto-prompt-opus\u002FSKILL.md",[],[],{"skillNo":237,"name":238,"nameZh":6,"description":239,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":240,"categories":241,"keywords":242,"publishedAt":19},"01M753YAP95W4K2MCEAEEAV6YA","to-prompt-gpt","Use when preparing or rewriting prompts for GPT-5.5, OpenAI API agents, Responses workflows, coding agents, research synthesis, support assistants, or model-specific prompt optimization. Do not use for Claude\u002FOpus prompts or raw context packaging without GPT-specific tuning.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fto-prompt-gpt\u002FSKILL.md",[],[],{"skillNo":244,"name":245,"nameZh":6,"description":246,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":247,"categories":248,"keywords":249,"publishedAt":19},"01M753Y700AZ0GVJDNW9Q1Q54F","plan-refactor-qa","Plans and runs qa-report before executing Compozy refactor tasks. Use when the user provides a refactor or issue slug and wants Codex to inspect the matching .compozy\u002Ftasks directory, related PRD\u002FTechSpec\u002FADR\u002Ftask artifacts, affected code, and existing tests, then invoke $qa-report with a repository-grounded prompt. Do not use to run tests, execute qa-execution, implement code, or perform post-refactor verification.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fplan-refactor-qa\u002FSKILL.md",[],[],{"skillNo":251,"name":252,"nameZh":6,"description":253,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":254,"categories":255,"keywords":256,"publishedAt":19},"01M753XZENG0Z8S2ET75EM8CGB","multi-tool-branch-review","Orchestrates a multi-tool branch review of the current git branch against a base branch. By default it runs two independent thermo-nuclear maintainability audits, one on Codex GPT-5.5 xhigh and one on Claude Opus xhigh, then consolidates the findings into a single remediation plan via writing-plans. If the user explicitly asks for native reviews, it can add the Claude native review pass, the Codex native review pass, or both. Use when the user wants a deep cross-model review of a branch or PR before merge, or asks to review this branch with multiple tools or models. Encodes known infra failure modes and their fixes (missing Claude ACP adapter, Codex MCP auth hangs, false-positive report files, long jobs orphaned inside subagents). Do not use for reviewing a single uncommitted snippet, for non-git work, for running only one reviewer, or when the user only wants a quick lint or test run.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fmulti-tool-branch-review\u002FSKILL.md",[],[],{"skillNo":258,"name":259,"nameZh":6,"description":260,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":261,"categories":262,"keywords":263,"publishedAt":19},"01M753XQM40XCK55BH5WPA88EW","create-pr-with-template","Create a GitHub Pull Request with gh CLI and prefer repository PR templates automatically. Use this whenever the user asks to open\u002Fcreate a PR, especially when template compliance is needed. If multiple templates exist, ask the user which template to use.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fcreate-pr-with-template\u002FSKILL.md",[],[],{"skillNo":265,"name":266,"nameZh":6,"description":267,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":268,"categories":269,"keywords":270,"publishedAt":19},"01M753XJMBJ8VFPRCDCC1JJ9G4","ui-craft","Provides guardrails for user-facing UI work: usability heuristics, accessibility floors, design-system discipline, component states, microcopy, motion, dark mode, responsive behavior, and human-AI UX. Use when designing, generating, reviewing, or refactoring visible product surfaces such as components, pages, dashboards, forms, dialogs, loading\u002Fempty\u002Ferror states, or AI interfaces. Do not use for backend-only work, infrastructure, CLI\u002FTUI design, or pure documentation editing.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fui-craft\u002FSKILL.md",[],[]]