[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ABK3NWSPS2QV3QH4WMHE0G":3,"skill-same:01M7ABK3NWSPS2QV3QH4WMHE0G":54},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M7ABK3NWSPS2QV3QH4WMHE0G","jsdoc-types",null,"Type-check plain .js files using JSDoc comments instead of migrating to TypeScript. Use when enabling or debugging checkJs\u002FallowJs\u002F`\u002F\u002F @ts-check`, adding @type\u002F@param\u002F@typedef\u002F@template annotations, typing a constructor function or ES6 class through JSDoc, or fixing a checkJs-only error (open-ended object literal, optional-by-default parameter, any-typed null\u002F[] initializer). Not for .d.ts files shipped with a package (declaration-contracts), tsconfig option selection beyond checkJs\u002FallowJs (tsconfig), or type-level generic utilities (advanced-types).","j0hanz\u002Fj0hanz-marketplace","j0hanz","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F159924955?v=4","01M7ABFK415CKHXYV9GZRJ16T7","Linus Johansson","01M7ABFK52FCPP2PNBH1YR7ZPA",0,"MIT","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Ftypescript-pro\u002Fskills\u002Fjsdoc-types\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: jsdoc-types\ndescription: Type-check plain .js files using JSDoc comments instead of migrating to TypeScript. Use when enabling or debugging checkJs\u002FallowJs\u002F`\u002F\u002F @ts-check`, adding @type\u002F@param\u002F@typedef\u002F@template annotations, typing a constructor function or ES6 class through JSDoc, or fixing a checkJs-only error (open-ended object literal, optional-by-default parameter, any-typed null\u002F[] initializer). Not for .d.ts files shipped with a package (declaration-contracts), tsconfig option selection beyond checkJs\u002FallowJs (tsconfig), or type-level generic utilities (advanced-types).\nmetadata:\n  category: reference\n---\n\n# Typed JavaScript with JSDoc\n\nA `.js` file has no `.ts` syntax available — every annotation lives in a comment, and everything left unannotated infers looser than the same code would in `.ts`.\n\n## Turn checking on\n\nProject-wide: `allowJs: true` plus `checkJs: true` in `tsconfig.json`\u002F`jsconfig.json` — `checkJs` alone does nothing, since `.js` files aren't in the program without `allowJs`. Per-file: `\u002F\u002F @ts-check` as the first line, `\u002F\u002F @ts-nocheck` to exempt one file from a project-wide `checkJs`. Errors are silent without these even when annotations are present.\n\n## The loop\n\n1. **Model the shape.** `@type` for a variable's type; `@param`\u002F`@returns` for a function's signature (`@param {string} [p]` marks it optional, `@param {string} [p=\"x\"]` gives a default); `@typedef`\u002F`@callback` for a shape reused across signatures; `@template` for a generic, `@template {string} K` to constrain it, `@template [T=object]` to default it. Reference a type from another file with `@import {Pet} from \".\u002Ftypes\"` or inline `import(\".\u002Ftypes\").Pet` — neither imports at runtime, only into the type space. Full tag syntax in [REFERENCE.md](REFERENCE.md#type-tags).\n\n   Done when every exported function and object has a `@param`\u002F`@returns`\u002F`@type` naming a concrete type, none left to bare inference.\n\n2. **Anchor classes and constructor functions.** A property's type is inferred from every `this.x = …` assignment inside the constructor; assignments only in methods are optional, and a property never assigned is untyped. Precede an assignment with `\u002F** @type {string | undefined} *\u002F` where the constructor sets it to `null`\u002F`undefined`\u002Fnothing meaningful. `@constructor` plus `@this` makes a plain function checked as a class. There is no `.js` syntax for a type argument in an `extends`\u002F`implements` clause — use `@extends`\u002F`@augments {Base\u003CArg>}` and `@implements {Iface\u003CArg>}`, or the argument silently defaults to `any`. `@override` needs `noImplicitOverride: true` in tsconfig to actually be checked.\n\n   Done when every class field, base-class generic argument, and access modifier (`@public`\u002F`@private`\u002F`@protected`\u002F`@readonly`\u002F`@override`) is declared rather than left to inference.\n\n3. **Close the loose defaults.** `.js` relaxes checks `.ts` enforces; each is closed by one explicit annotation:\n   - object literal is open-ended (implicit `[x: string]: any`) unless the variable it initializes carries a JSDoc type\n   - a `null`\u002F`undefined`\u002F`[]` initializer types as `any`\u002F`any[]` regardless of `strictNullChecks`, unless annotated\n   - every parameter is optional — calling with fewer arguments never errors — unless the function carries `@param`; calling with _more_ arguments than declared still errors either way\n   - a function body referencing `arguments` gets an implicit `(...args: any[]) => any`; `@param {...number} args` types it\n   - a type argument the compiler can't infer (unconstrained generic call, or the extends-clause case above) defaults to `any`\n\n   Done when a `checkJs` run shows no gap from this list — each object literal, nullable initializer, parameter list, and generic call site carries an explicit type instead of the JS-mode default.\n\n4. **Prove it.** Run the project's `tsc`\u002Feditor diagnostics with `checkJs` on. `\u002F\u002F @ts-expect-error` works in `.js` exactly as in `.ts` — put it above a call or assignment that must fail; the compiler flags the directive itself if the line stops erroring.\n\n   Done when checking reports zero unintended errors and every `@ts-expect-error` line genuinely fails without its directive.\n\n## Casts, satisfies, const\n\n- `\u002F** @type {T} *\u002F (expr)` — the only cast syntax available in `.js` (no `as` operator); parenthesize `expr`.\n- `\u002F** @satisfies {T} *\u002F (expr)` — checks against `T` without widening `expr`'s own inferred type, same as the `satisfies` operator.\n- `\u002F** @type {const} *\u002F (expr)` — JSDoc equivalent of `as const`.\n\n## Reference\n\nTag-by-tag syntax, legacy Closure type synonyms, patterns JSDoc supports that TypeScript doesn't (and vice versa), and a symptom → fix table: [REFERENCE.md](REFERENCE.md).\n","# Typed JavaScript with JSDoc\n\nA `.js` file has no `.ts` syntax available — every annotation lives in a comment, and everything left unannotated infers looser than the same code would in `.ts`.\n\n## Turn checking on\n\nProject-wide: `allowJs: true` plus `checkJs: true` in `tsconfig.json`\u002F`jsconfig.json` — `checkJs` alone does nothing, since `.js` files aren't in the program without `allowJs`. Per-file: `\u002F\u002F @ts-check` as the first line, `\u002F\u002F @ts-nocheck` to exempt one file from a project-wide `checkJs`. Errors are silent without these even when annotations are present.\n\n## The loop\n\n1. **Model the shape.** `@type` for a variable's type; `@param`\u002F`@returns` for a function's signature (`@param {string} [p]` marks it optional, `@param {string} [p=\"x\"]` gives a default); `@typedef`\u002F`@callback` for a shape reused across signatures; `@template` for a generic, `@template {string} K` to constrain it, `@template [T=object]` to default it. Reference a type from another file with `@import {Pet} from \".\u002Ftypes\"` or inline `import(\".\u002Ftypes\").Pet` — neither imports at runtime, only into the type space. Full tag syntax in [REFERENCE.md](REFERENCE.md#type-tags).\n\n   Done when every exported function and object has a `@param`\u002F`@returns`\u002F`@type` naming a concrete type, none left to bare inference.\n\n2. **Anchor classes and constructor functions.** A property's type is inferred from every `this.x = …` assignment inside the constructor; assignments only in methods are optional, and a property never assigned is untyped. Precede an assignment with `\u002F** @type {string | undefined} *\u002F` where the constructor sets it to `null`\u002F`undefined`\u002Fnothing meaningful. `@constructor` plus `@this` makes a plain function checked as a class. There is no `.js` syntax for a type argument in an `extends`\u002F`implements` clause — use `@extends`\u002F`@augments {Base\u003CArg>}` and `@implements {Iface\u003CArg>}`, or the argument silently defaults to `any`. `@override` needs `noImplicitOverride: true` in tsconfig to actually be checked.\n\n   Done when every class field, base-class generic argument, and access modifier (`@public`\u002F`@private`\u002F`@protected`\u002F`@readonly`\u002F`@override`) is declared rather than left to inference.\n\n3. **Close the loose defaults.** `.js` relaxes checks `.ts` enforces; each is closed by one explicit annotation:\n   - object literal is open-ended (implicit `[x: string]: any`) unless the variable it initializes carries a JSDoc type\n   - a `null`\u002F`undefined`\u002F`[]` initializer types as `any`\u002F`any[]` regardless of `strictNullChecks`, unless annotated\n   - every parameter is optional — calling with fewer arguments never errors — unless the function carries `@param`; calling with _more_ arguments than declared still errors either way\n   - a function body referencing `arguments` gets an implicit `(...args: any[]) => any`; `@param {...number} args` types it\n   - a type argument the compiler can't infer (unconstrained generic call, or the extends-clause case above) defaults to `any`\n\n   Done when a `checkJs` run shows no gap from this list — each object literal, nullable initializer, parameter list, and generic call site carries an explicit type instead of the JS-mode default.\n\n4. **Prove it.** Run the project's `tsc`\u002Feditor diagnostics with `checkJs` on. `\u002F\u002F @ts-expect-error` works in `.js` exactly as in `.ts` — put it above a call or assignment that must fail; the compiler flags the directive itself if the line stops erroring.\n\n   Done when checking reports zero unintended errors and every `@ts-expect-error` line genuinely fails without its directive.\n\n## Casts, satisfies, const\n\n- `\u002F** @type {T} *\u002F (expr)` — the only cast syntax available in `.js` (no `as` operator); parenthesize `expr`.\n- `\u002F** @satisfies {T} *\u002F (expr)` — checks against `T` without widening `expr`'s own inferred type, same as the `satisfies` operator.\n- `\u002F** @type {const} *\u002F (expr)` — JSDoc equivalent of `as const`.\n\n## Reference\n\nTag-by-tag syntax, legacy Closure type synonyms, patterns JSDoc supports that TypeScript doesn't (and vice versa), and a symptom → fix table: [REFERENCE.md](REFERENCE.md).\n",{"name":5,"metadata":24,"description":7},{"category":25},"reference","main","534498267dccbe415f22f31fceac9da6771c195f","plugins\u002Ftypescript-pro\u002Fskills\u002Fjsdoc-types","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace","https:\u002F\u002Fj0hanz-marketplace.vercel.app","https:\u002F\u002Fgithub.com\u002Fj0hanz","linus-johansson-cv-d308be9b73e1.herokuapp.com","2026-11-15 02:42:07",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add j0hanz\u002Fj0hanz-marketplace --skill jsdoc-types",{"tool":40,"command":41},"bunx","bunx skills add j0hanz\u002Fj0hanz-marketplace --skill jsdoc-types",{"tool":43,"command":44},"pnpm","pnpm dlx skills add j0hanz\u002Fj0hanz-marketplace --skill jsdoc-types","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Ftypescript-pro\u002Fskills\u002Fjsdoc-types\u002FSKILL.md",true,[48],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"REFERENCE.md","REFERENCE","参考文档",8461,"https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Ftypescript-pro\u002Fskills\u002Fjsdoc-types\u002FREFERENCE.md",[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7ABP78JFYBMCXJ9GMETCYZM","unslop","Use when writing or editing prose a person will read, or when text sounds AI-generated.","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwriteup\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7ABP52BNV7NRPNBR6PCNZWC","show-me","Use when asked to show, diagram, or walk through how code fits together or what a change does, or before explaining a multi-file flow in prose.","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwriteup\u002Fskills\u002Fshow-me\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7ABP3EPN4KFB4HPJNMY31NR","pr","Use when writing or updating a pull request description, or before running `gh pr create`.","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwriteup\u002Fskills\u002Fpr\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7ABP08MXTHPZYTG4HKEP7WQ","commit","Use when writing a commit message, or before running `git commit`.","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fwriteup\u002Fskills\u002Fcommit\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7ABNV9J7DN1AFRBGDBHVBY2","write-specs","Spec a feature's observable behavior. Use when asked for requirements, when a request says what the system should do but not how, or to capture what a built system already guarantees. Not for how to build it (write-plan).","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fworkbench\u002Fskills\u002Fwrite-specs\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7ABNPK2GVG8EB3SSEAMK4FZ","write-skills","Write, fix, or audit a skill's frontmatter, trigger description, and body. Use when a skill is asked for, never fires, or fires at the wrong moment. Not for a hook (write-hooks) or the plugin manifest and catalog.","https:\u002F\u002Fgithub.com\u002Fj0hanz\u002Fj0hanz-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fworkbench\u002Fskills\u002Fwrite-skills\u002FSKILL.md",[],[]]