[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AE0M9N73VBFED82099PDYS":3,"skill-same:01M7AE0M9N73VBFED82099PDYS":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":32,"commitSha":33,"skillDirectory":34,"forksCount":35,"repositoryHtmlUrl":36,"repositoryHomepageUrl":37,"ownerHtmlUrl":38,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":39,"install":40,"resources":53},"01M7AE0M9N73VBFED82099PDYS","typescript-node",null,"Use when writing or reviewing TypeScript or Node.js code. Strict mode, async\u002Fawait footguns, error handling, null safety, real types vs any, ESM\u002FCJS interop, npm hygiene (engines, lockfile, scripts, ci).","Leostruka\u002Fdevin-bundle","Leostruka","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F81370685?v=4","01M7AD8MAK63VDNAWRDRRRW04N","leandro ostruka","01M7AD8MBS65YDS1KMMV7YPM07",0,"MIT","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Fskills\u002Ftypescript-node\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: typescript-node\ndescription: Use when writing or reviewing TypeScript or Node.js code. Strict mode, async\u002Fawait footguns, error handling, null safety, real types vs any, ESM\u002FCJS interop, npm hygiene (engines, lockfile, scripts, ci).\ntriggers: [user, model]\nallowed-tools: [read, exec, grep, edit]\n---\n\n# TypeScript & Node.js\n\nModern TypeScript and Node.js. The compiler only helps if you do not lie to it - `any`, `as`, and `!` disable the protection that justifies the cost of TS.\n\n## Config and types\n\n- `strict: true` in tsconfig (includes `strictNullChecks`, `noImplicitAny`). A project without strict is JavaScript with annotations.\n- `noUncheckedIndexedAccess` for safe indexing (`arr[i]` returns `T | undefined` - the source of most \"undefined is not a function\" bugs).\n- `exactOptionalPropertyTypes` when the repo uses it - `x?: T` does not accept explicit `undefined`.\n- `any` = virus: propagates and disables checking. Prefer `unknown` + narrowing (`typeof`, `instanceof`, type guard).\n- `as T` only when you KNOW more than the compiler (rarely). `satisfies` validates without widening.\n- `!` non-null assertion = \"trust me\": use only after a check that guarantees it, or refactor to narrowing.\n- Type guard: `function isX(v: unknown): v is X` - real narrowing instead of cast.\n- `interface` for objects\u002Fcontracts, `type` for unions\u002Fintersections\u002Futilities. `enum` only when a runtime value is needed; `as const` + union covers the rest.\n- Generics with constraints (`\u003CT extends X>`); hidden `any` in a generic does not count as typed.\n\n## Null safety\n\n- `?.`\u002F`??` for optional access and fallback; `??` (not `||`) when `0`\u002F`''`\u002F`false` are valid values - `||` swallows them.\n- `Array.find`\u002F`Map.get` return `undefined`: handle it, do not assume.\n- External API data is `unknown` until validated: `zod`\u002F`valibot` at the boundary (parse, not cast) - `JSON.parse` returns `any` and lies.\n- With `strictNullChecks` on, `T | null | undefined` is explicit - do not bypass with `!`.\n\n## Async\u002Fawait footguns\n\n- Forgotten `await` = dangling promise: an `async` returning `Promise\u003CT>` must be awaited or returned.\n- `forEach(async)` does NOT wait: runs in parallel without awaiting. Correct: sequential `for...of` or `Promise.all(map)` for parallel.\n- `Promise.all` rejects on the first failure and abandons the others (which keep running). `Promise.allSettled` when each result matters.\n- try\u002Fcatch only catches errors after `await` - a promise without await escapes the try (floating promise). ESLint `@typescript-eslint\u002Fno-floating-promises` catches this.\n- `unhandledRejection` crashes modern Node: every promise gets await, `.catch()`, or `Promise.allSettled`.\n- `async` in event-handler\u002Ffire-and-forget callbacks: explicit `.catch(log)`.\n- Fetch timeout: `AbortSignal.timeout(ms)` - fetch without timeout can hang forever.\n\n## Error handling\n\n- `throw new Error('msg', { cause: e })` - never `throw 'string'` or `throw e` without context.\n- `catch (e)`: `e` is `unknown` under strict - narrow (`e instanceof Error`) before `e.message`.\n- Custom errors: class `extends Error` with `name` - `instanceof` distinguishes failure types.\n- A catch that only logs and continues = swallowing: handle or re-throw with context.\n- `process.on('unhandledRejection')` as a safety net in services - not as a strategy.\n\n## Node and runtime\n\n- `node:fs\u002Fpromises` over sync callbacks; sync (`readFileSync`) blocks the whole event loop - only in scripts\u002FCLIs, never in servers.\n- Buffer\u002Fstream for large files; whole-file `readFile` into memory explodes on big files.\n- `process.env.X` is `string | undefined`: validate at the boundary (throw at boot if missing) or explicit default - never `process.env.KEY!`.\n- ESM (`import`) vs CJS (`require`): new projects ESM (`\"type\": \"module\"`); `__dirname` does not exist in ESM (`import.meta.dirname` on Node 20.11+).\n- Top-level await only in ESM; in CJS wrap in `async main()`.\n\n## npm and dependencies\n\n- `npm ci` in CI\u002Fdeploy (respects lockfile); `npm install` only in dev.\n- `engines.node` declared; version pinned via `.nvmrc`\u002Fdevcontainers.\n- Dependency `prepublish`\u002F`postinstall` scripts are supply-chain surface - `npm install --ignore-scripts` when not needed.\n- `npm audit`\u002F`npm ls \u003Cpkg>` before adopting a dep; commit the lockfile together with `package.json` (dep change without lockfile = CI installs something different from local).\n- `npx` executes remote code: `npx pkg` downloads and runs - confirm the package is official.\n\n## Common review findings\n\n- `any`\u002F`as`\u002F`!` proliferating (fake typing).\n- `forEach(async)` or `map` with async without `Promise.all`.\n- Promises without await\u002Fcatch (floating).\n- `||` where `??` was meant (swallows `0`\u002F`''`).\n- `JSON.parse`\u002F`res.json()` cast straight to a type (lie).\n- `process.env.X` used unvalidated.\n- `readFileSync`\u002F`execSync` in a server (blocks the loop).\n- `try` without a real `catch` (empty catch, log-only catch).\n- New dependency without updated `package-lock`.\n- `console.log` of large objects\u002Fobjects with secrets in prod.\n\n## Cascade\n\n- JS test fundamentals: `testing` (vitest\u002Fjest at the boundary).\n- npm\u002Fshell script footguns: `shell-safe`.\n- Node CI (npm ci, cache): `github-actions`, `deploy`.\n","# TypeScript & Node.js\n\nModern TypeScript and Node.js. The compiler only helps if you do not lie to it - `any`, `as`, and `!` disable the protection that justifies the cost of TS.\n\n## Config and types\n\n- `strict: true` in tsconfig (includes `strictNullChecks`, `noImplicitAny`). A project without strict is JavaScript with annotations.\n- `noUncheckedIndexedAccess` for safe indexing (`arr[i]` returns `T | undefined` - the source of most \"undefined is not a function\" bugs).\n- `exactOptionalPropertyTypes` when the repo uses it - `x?: T` does not accept explicit `undefined`.\n- `any` = virus: propagates and disables checking. Prefer `unknown` + narrowing (`typeof`, `instanceof`, type guard).\n- `as T` only when you KNOW more than the compiler (rarely). `satisfies` validates without widening.\n- `!` non-null assertion = \"trust me\": use only after a check that guarantees it, or refactor to narrowing.\n- Type guard: `function isX(v: unknown): v is X` - real narrowing instead of cast.\n- `interface` for objects\u002Fcontracts, `type` for unions\u002Fintersections\u002Futilities. `enum` only when a runtime value is needed; `as const` + union covers the rest.\n- Generics with constraints (`\u003CT extends X>`); hidden `any` in a generic does not count as typed.\n\n## Null safety\n\n- `?.`\u002F`??` for optional access and fallback; `??` (not `||`) when `0`\u002F`''`\u002F`false` are valid values - `||` swallows them.\n- `Array.find`\u002F`Map.get` return `undefined`: handle it, do not assume.\n- External API data is `unknown` until validated: `zod`\u002F`valibot` at the boundary (parse, not cast) - `JSON.parse` returns `any` and lies.\n- With `strictNullChecks` on, `T | null | undefined` is explicit - do not bypass with `!`.\n\n## Async\u002Fawait footguns\n\n- Forgotten `await` = dangling promise: an `async` returning `Promise\u003CT>` must be awaited or returned.\n- `forEach(async)` does NOT wait: runs in parallel without awaiting. Correct: sequential `for...of` or `Promise.all(map)` for parallel.\n- `Promise.all` rejects on the first failure and abandons the others (which keep running). `Promise.allSettled` when each result matters.\n- try\u002Fcatch only catches errors after `await` - a promise without await escapes the try (floating promise). ESLint `@typescript-eslint\u002Fno-floating-promises` catches this.\n- `unhandledRejection` crashes modern Node: every promise gets await, `.catch()`, or `Promise.allSettled`.\n- `async` in event-handler\u002Ffire-and-forget callbacks: explicit `.catch(log)`.\n- Fetch timeout: `AbortSignal.timeout(ms)` - fetch without timeout can hang forever.\n\n## Error handling\n\n- `throw new Error('msg', { cause: e })` - never `throw 'string'` or `throw e` without context.\n- `catch (e)`: `e` is `unknown` under strict - narrow (`e instanceof Error`) before `e.message`.\n- Custom errors: class `extends Error` with `name` - `instanceof` distinguishes failure types.\n- A catch that only logs and continues = swallowing: handle or re-throw with context.\n- `process.on('unhandledRejection')` as a safety net in services - not as a strategy.\n\n## Node and runtime\n\n- `node:fs\u002Fpromises` over sync callbacks; sync (`readFileSync`) blocks the whole event loop - only in scripts\u002FCLIs, never in servers.\n- Buffer\u002Fstream for large files; whole-file `readFile` into memory explodes on big files.\n- `process.env.X` is `string | undefined`: validate at the boundary (throw at boot if missing) or explicit default - never `process.env.KEY!`.\n- ESM (`import`) vs CJS (`require`): new projects ESM (`\"type\": \"module\"`); `__dirname` does not exist in ESM (`import.meta.dirname` on Node 20.11+).\n- Top-level await only in ESM; in CJS wrap in `async main()`.\n\n## npm and dependencies\n\n- `npm ci` in CI\u002Fdeploy (respects lockfile); `npm install` only in dev.\n- `engines.node` declared; version pinned via `.nvmrc`\u002Fdevcontainers.\n- Dependency `prepublish`\u002F`postinstall` scripts are supply-chain surface - `npm install --ignore-scripts` when not needed.\n- `npm audit`\u002F`npm ls \u003Cpkg>` before adopting a dep; commit the lockfile together with `package.json` (dep change without lockfile = CI installs something different from local).\n- `npx` executes remote code: `npx pkg` downloads and runs - confirm the package is official.\n\n## Common review findings\n\n- `any`\u002F`as`\u002F`!` proliferating (fake typing).\n- `forEach(async)` or `map` with async without `Promise.all`.\n- Promises without await\u002Fcatch (floating).\n- `||` where `??` was meant (swallows `0`\u002F`''`).\n- `JSON.parse`\u002F`res.json()` cast straight to a type (lie).\n- `process.env.X` used unvalidated.\n- `readFileSync`\u002F`execSync` in a server (blocks the loop).\n- `try` without a real `catch` (empty catch, log-only catch).\n- New dependency without updated `package-lock`.\n- `console.log` of large objects\u002Fobjects with secrets in prod.\n\n## Cascade\n\n- JS test fundamentals: `testing` (vitest\u002Fjest at the boundary).\n- npm\u002Fshell script footguns: `shell-safe`.\n- Node CI (npm ci, cache): `github-actions`, `deploy`.\n",{"name":5,"triggers":24,"description":7,"allowed-tools":27},[25,26],"user","model",[28,29,30,31],"read","exec","grep","edit","main","02b95ddb62959a00b3c31442c2046aca0d19563c","skills\u002Ftypescript-node",1,"https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle","https:\u002F\u002Fleostruka.github.io\u002Fdevin-bundle\u002F","https:\u002F\u002Fgithub.com\u002FLeostruka","2026-11-15 05:19:58",{"source":8,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add Leostruka\u002Fdevin-bundle --skill typescript-node",{"tool":46,"command":47},"bunx","bunx skills add Leostruka\u002Fdevin-bundle --skill typescript-node",{"tool":49,"command":50},"pnpm","pnpm dlx skills add Leostruka\u002Fdevin-bundle --skill typescript-node","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Fskills\u002Ftypescript-node\u002FSKILL.md",true,[],[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},"01M7E0K3MG2XC4FSRV0MK6SFR1","montador-de-ideias","Use when assembling, expanding, or elevating a raw project idea or initial prompt into an ultra-detailed, first-principles dossier and compiled master prompt with journalistic OSINT market research, Tech Lead and Staff Architect justifications, atomic and modular hardening\u002Foptimization, and high-impact contact surfaces.","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Fskills\u002Fmontador-de-ideias\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},"01M7E0J7JJWZ8QMK01RZ3B3C9Z","git-github-adaptive-engineering","Use when any task touches git history, GitHub issues\u002FPRs\u002Freleases\u002FCI, repo governance, or branch and merge decisions. Runs the Fase Zero situational-awareness battery, picks one of five delivery flows via the adaptive decision engine, and enforces commit\u002FPR information-density standards. Orchestrates the gh, git-workflows, github-actions, pr, and debug\u002Ffinish skills.","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Fskills\u002Fgit-github-adaptive-engineering\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},"01M7E0GJFRPFEVQQMXEM58EWDM","adaptive-agenda-calendar-routine-engine","Use when planning or executing work across hours, days, weeks, or sprints. Turns the calendar into a strict time-blocked agenda (HH:MM-HH:MM blocks carrying a routine profile, expected inputs, and a handoff output artifact), runs the 5-stage cognitive flow (Radar and Hunt -> Triage plus Steve Jobs conception -> workbench manifest -> >=32-cycle loop -> Close plus Open-Minded Scrum), and unfolds macro calendar milestones into micro agenda blocks through extensions\u002Fgcal\u002Fwrapper.py.","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Fskills\u002Fadaptive-agenda-calendar-routine-engine\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},"01M7AE2K9FTY0BVS48N0A9JFKF","demo","Use when demonstrating a skill in a fixture project.","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fdevin-config\u002Fproject\u002F.devin\u002Fskills\u002Fdemo\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},"01M7AE2G3DP38PTV3B1N7MW5TS","duplicate-skill","Use when testing duplicate skill name detection.","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fdevin-config\u002Fproject\u002F.devin\u002Fskills\u002Fbeta\u002FSKILL.md",[],[],{"skillNo":91,"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":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AE2DBR8ZHT6T875MJ392GK","https:\u002F\u002Fgithub.com\u002FLeostruka\u002Fdevin-bundle\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fdevin-config\u002Fproject\u002F.devin\u002Fskills\u002Falpha\u002FSKILL.md",[],[]]