[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EJJHX3HZ2FP5S37SWXB3ER":3,"skill-same:01M7EJJHX3HZ2FP5S37SWXB3ER":44},{"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":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7EJJHX3HZ2FP5S37SWXB3ER","typescript-dev",null,"Use before writing or explaining strict TypeScript, and before writing a bun:test file: our own types validated where data is mapped into them, narrowing instead of casting, Result instead of throwing, branded types, using for cleanup, the compiler-cost traps (interface vs intersection, const enum, tsgo), and the bun:test idiom. Triggers: writing TypeScript, idiomatic TS, type narrowing, discriminated union, branded type, Result type, parse JSON into a type, tsconfig strictness, interface vs type, const enum, tsgo, TypeScript 7, write a test in bun test, describe and it, mock in bun test, run only this test. Bun runtime APIs are bun-dev; which cases to test is software-testing.","qsmark-labs\u002Fqsm-marketplace","qsmark-labs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F348383745?v=4","01M7EJDK5MKZ67A7JBGC3ZB1RP","QSM-LABS","01M7EJDK6649PCGA2ENGFMFA7E",0,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-langdev-ts\u002Fskills\u002Ftypescript-dev\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: typescript-dev\ndescription: \"Use before writing or explaining strict TypeScript, and before writing a bun:test file: our own types validated where data is mapped into them, narrowing instead of casting, Result instead of throwing, branded types, using for cleanup, the compiler-cost traps (interface vs intersection, const enum, tsgo), and the bun:test idiom. Triggers: writing TypeScript, idiomatic TS, type narrowing, discriminated union, branded type, Result type, parse JSON into a type, tsconfig strictness, interface vs type, const enum, tsgo, TypeScript 7, write a test in bun test, describe and it, mock in bun test, run only this test. Bun runtime APIs are bun-dev; which cases to test is software-testing.\"\n---\n\n# Writing TypeScript\n\nStrict TypeScript for this machine, typed with our own types: a value with rules gets a type that\nvalidates once, where outside data is mapped into it, so code past that line holds a value that\ncannot be invalid. The compiler and lint gate reject the rest; this skill holds the choices they\ncannot make. Out of scope: a tutorial, Bun APIs (bun-dev).\n\nThe gate: `qsm-langdev init` writes `tsconfig.qsm.json` and `.oxlintrc.json`, which require `strict`,\n`noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`, `verbatimModuleSyntax`, `??` over `||`,\nno `any` flowing into a typed value, and every promise awaited; oxfmt formats.\nWrite against them; do not restate them in code or prose. A repository may opt into\n`isolatedDeclarations` (explicit return type on every export) and `erasableSyntaxOnly` (no enums,\nno namespaces with code, no parameter properties).\n\n## Our own types, validated at the mapping\n\nA string that is an email, a number that is an age, an id that must not be swapped: each gets its\nown type, built by one parse function that is the only place the rule is written and the only\ncast. The mapping from `unknown` is where it fails, with a named error, so nothing past it\nre-checks.\n\n```ts\ntype Email = string & { readonly __brand: \"Email\" };\nclass InvalidEmail extends Error { override readonly name = \"InvalidEmail\"; }\nconst parseEmail = (raw: unknown): Result\u003CEmail, InvalidEmail> =>\n  typeof raw === \"string\" && \u002F^[^@\\s]+@[^@\\s]+$\u002F.test(raw)\n    ? { ok: true, value: raw as Email }\n    : { ok: false, error: new InvalidEmail(String(raw)) };\n```\n\nThe record that holds the parsed fields is a plain type built from those values, never\n`JSON.parse(raw) as User`. A closed set (`\"free\" | \"pro\"`) is a literal union checked at the same\nplace. Parse the environment once at startup the same way.\n\n## Rules\n\n- Narrow with a type predicate, never cast, because a cast moves the crash to run time. Close every\n  union with `assertNever(x: never)`, so a missing arm is a compile error.\n- Narrow a `catch` binding (`unknown`) with `instanceof Error`, and rethrow with `{ cause: err }`.\n- Return `{ ok: true; value } | { ok: false; error }` for a failure the caller handles; throw only\n  for what nobody can handle, because a throw is invisible in the type. Give a domain failure its\n  own class with a `name`.\n- Make a state with behaviour its own type, not an enum, because an enum cannot own its transitions.\n- Use `using` and `await using` instead of `try\u002Ffinally` for a resource with an owner.\n- Use `interface ... extends` over an intersection, because it is cached and gives shorter errors.\n- Never use `const enum`; use `{ Up: \"Up\" } as const` plus `(typeof X)[keyof typeof X]`, because\n  esbuild, swc, Bun and tsgo cannot inline it across files.\n- Before moving to tsgo (TypeScript 7), turn on `isolatedModules`, because tsgo checks files in\n  isolation and code that compiles only through tsc's cross-file inference breaks. A `TS6xxx`\n  deprecation in 6.x is a blocker, and an orphaned `references[]` entry now errors.\n\n## Tests in bun:test\n\nOne file per unit, `order-service.test.ts`, with test data that shows only what matters, built by a\nsmall factory (`aUser({ active: false })`), because a shared twenty-field fixture breaks fifty\ntests at once. Whether a test is needed is software-testing.\n\n- Import `describe`, `it`, `expect` from `bun:test`, never rely on globals. `describe` names the\n  unit, `it` the case as a sentence, two levels at most.\n- `beforeEach` builds fresh state; `beforeAll` only for expensive read-only setup, because mutated\n  shared state is the first flaky test.\n- `it.each` with the row in the title, so the report says which input failed.\n- `await expect(p).rejects.toThrow(\"msg\")`; an unawaited promise passes before it fails.\n- Pass a dependency in rather than `mock.module`, which replaces a module for the whole file;\n  `spyOn` wraps one method, and `mock.restore()` goes in `afterEach`.\n- `setSystemTime(date)` around code that reads the clock, `setSystemTime()` after, never\n  `Bun.sleep` to wait for time.\n- Run one file `bun test order-service`, one test `bun test -t \"rejects payment\"`.\n\n## Red flags\n\n- When a test still passes with the code under test deleted, assert the result, because it proves\n  nothing.\n- When a `string` or `number` carries a domain meaning past the parse, give it a type, because the\n  next caller will pass the wrong one.\n\n## Say it in the reply\n\nWhen you avoided a cast, an enum or a throw, say what replaced it, and name the one place each\nvalue is validated. For a test file: file, count, and the command that runs it.\n","# Writing TypeScript\n\nStrict TypeScript for this machine, typed with our own types: a value with rules gets a type that\nvalidates once, where outside data is mapped into it, so code past that line holds a value that\ncannot be invalid. The compiler and lint gate reject the rest; this skill holds the choices they\ncannot make. Out of scope: a tutorial, Bun APIs (bun-dev).\n\nThe gate: `qsm-langdev init` writes `tsconfig.qsm.json` and `.oxlintrc.json`, which require `strict`,\n`noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`, `verbatimModuleSyntax`, `??` over `||`,\nno `any` flowing into a typed value, and every promise awaited; oxfmt formats.\nWrite against them; do not restate them in code or prose. A repository may opt into\n`isolatedDeclarations` (explicit return type on every export) and `erasableSyntaxOnly` (no enums,\nno namespaces with code, no parameter properties).\n\n## Our own types, validated at the mapping\n\nA string that is an email, a number that is an age, an id that must not be swapped: each gets its\nown type, built by one parse function that is the only place the rule is written and the only\ncast. The mapping from `unknown` is where it fails, with a named error, so nothing past it\nre-checks.\n\n```ts\ntype Email = string & { readonly __brand: \"Email\" };\nclass InvalidEmail extends Error { override readonly name = \"InvalidEmail\"; }\nconst parseEmail = (raw: unknown): Result\u003CEmail, InvalidEmail> =>\n  typeof raw === \"string\" && \u002F^[^@\\s]+@[^@\\s]+$\u002F.test(raw)\n    ? { ok: true, value: raw as Email }\n    : { ok: false, error: new InvalidEmail(String(raw)) };\n```\n\nThe record that holds the parsed fields is a plain type built from those values, never\n`JSON.parse(raw) as User`. A closed set (`\"free\" | \"pro\"`) is a literal union checked at the same\nplace. Parse the environment once at startup the same way.\n\n## Rules\n\n- Narrow with a type predicate, never cast, because a cast moves the crash to run time. Close every\n  union with `assertNever(x: never)`, so a missing arm is a compile error.\n- Narrow a `catch` binding (`unknown`) with `instanceof Error`, and rethrow with `{ cause: err }`.\n- Return `{ ok: true; value } | { ok: false; error }` for a failure the caller handles; throw only\n  for what nobody can handle, because a throw is invisible in the type. Give a domain failure its\n  own class with a `name`.\n- Make a state with behaviour its own type, not an enum, because an enum cannot own its transitions.\n- Use `using` and `await using` instead of `try\u002Ffinally` for a resource with an owner.\n- Use `interface ... extends` over an intersection, because it is cached and gives shorter errors.\n- Never use `const enum`; use `{ Up: \"Up\" } as const` plus `(typeof X)[keyof typeof X]`, because\n  esbuild, swc, Bun and tsgo cannot inline it across files.\n- Before moving to tsgo (TypeScript 7), turn on `isolatedModules`, because tsgo checks files in\n  isolation and code that compiles only through tsc's cross-file inference breaks. A `TS6xxx`\n  deprecation in 6.x is a blocker, and an orphaned `references[]` entry now errors.\n\n## Tests in bun:test\n\nOne file per unit, `order-service.test.ts`, with test data that shows only what matters, built by a\nsmall factory (`aUser({ active: false })`), because a shared twenty-field fixture breaks fifty\ntests at once. Whether a test is needed is software-testing.\n\n- Import `describe`, `it`, `expect` from `bun:test`, never rely on globals. `describe` names the\n  unit, `it` the case as a sentence, two levels at most.\n- `beforeEach` builds fresh state; `beforeAll` only for expensive read-only setup, because mutated\n  shared state is the first flaky test.\n- `it.each` with the row in the title, so the report says which input failed.\n- `await expect(p).rejects.toThrow(\"msg\")`; an unawaited promise passes before it fails.\n- Pass a dependency in rather than `mock.module`, which replaces a module for the whole file;\n  `spyOn` wraps one method, and `mock.restore()` goes in `afterEach`.\n- `setSystemTime(date)` around code that reads the clock, `setSystemTime()` after, never\n  `Bun.sleep` to wait for time.\n- Run one file `bun test order-service`, one test `bun test -t \"rejects payment\"`.\n\n## Red flags\n\n- When a test still passes with the code under test deleted, assert the result, because it proves\n  nothing.\n- When a `string` or `number` carries a domain meaning past the parse, give it a type, because the\n  next caller will pass the wrong one.\n\n## Say it in the reply\n\nWhen you avoided a cast, an enum or a throw, say what replaced it, and name the one place each\nvalue is validated. For a test file: file, count, and the command that runs it.\n",{"name":5,"description":7},"main","c385fc50aadaee7296445e049153ce0560a9c80c","plugins\u002Fqsm-langdev-ts\u002Fskills\u002Ftypescript-dev","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace","https:\u002F\u002Fgithub.com\u002Fqsmark-labs","2026-11-13 18:31:51",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add qsmark-labs\u002Fqsm-marketplace --skill typescript-dev",{"tool":36,"command":37},"bunx","bunx skills add qsmark-labs\u002Fqsm-marketplace --skill typescript-dev",{"tool":39,"command":40},"pnpm","pnpm dlx skills add qsmark-labs\u002Fqsm-marketplace --skill typescript-dev","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-langdev-ts\u002Fskills\u002Ftypescript-dev\u002FSKILL.md",true,[],[45,52,59,66,73,80],{"skillNo":46,"name":47,"nameZh":6,"description":48,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":19},"01M7EJWPJ0B4E1P148MWQ3GMR8","worktrunk","Use when working with git worktrees or wt (worktrunk): creating, switching, merging or removing a branch workspace, configuring wt (project or personal config, workflow hooks around switch, commit and merge, commit-message generation, hook approvals), or a wt command that failed. Triggers: make a worktree for this branch, wt merge, wt remove, configure wt, .config\u002Fwt.toml, run tests before merge, install deps when a worktree is created, wt hook, wt switch does not cd, nastav wt, wt nefunguje.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-worktrunk\u002Fskills\u002Fworktrunk\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7EJWD4F683TF21N89JGWZB2","web-ladder","Use when a task needs something the internet holds: look something up, search the web, find which page answers a question, read a page, check a library's current docs, a page that needs a browser or shows a captcha. Runs one research loop: searxng search, keywords, cases, search again up to three times, Context7 for a library, Tavily when the keywords will not come, one page in a browser, the person on a wall. Triggers: look this up, search the web, find out online, read this page, check the docs, the page is blocked, captcha, najdi na webu, otevri tu stranku. A multi-round question goes to the qsm-web:web-research agent; one tool's commands are its own skill (searxng, browserbox, opensrc).","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fweb-ladder\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7EJW9G0K6AS5Z4H0B0K6NDB","searxng","Use when running a web search through the person's own SearXNG instance with qsm-web searxng: choosing a search profile or engines, the instance, time range or language, reading its JSON, a suspended engine. Triggers: search with searxng, qsm-web searxng, search profile, niche search, academic search, IT search, vyhledavaci profil, searxng is down, which engines. The research loop around it is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fsearxng\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7EJW40RD3DRBQVVCW6K7NMG","opensrc","Use when the source code of an open-source library or repository is needed on disk to read: the docs are silent, the behaviour must be checked in code, the version the project pins. Runs qsm-web opensrc get with a package spec or a repository address. Triggers: get the source of this package, clone this library, read the library's code, qsm-web opensrc, stahni zdrojak knihovny. Library docs are the Context7 skill; the research loop is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fopensrc\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7EJVZWD6J7W91G69GMBWBQS","browserbox","Use when one page needs a real browser through qsm-web browserbox: content built by script, a page that blocks plain fetching, a captcha to solve or hand to the person, a scripted sequence of clicks, a login the person is present for. Triggers: open it in a browser, the page is empty without JavaScript, captcha, take over the browser, run these steps on the page, log in to this site, browserbox. When to reach for a browser at all is the web-ladder skill.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-web\u002Fskills\u002Fbrowserbox\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7EJVSZC1E8ZGVE8KXVFPR9S","usage","Use when the user wants a review of how they use Claude Code, or setup hands over after a first install: review my Claude Code usage, audit my setup, what does my setup cost, where did my tokens go, clean up my Claude Code, usage report, zkontroluj moje pouzivani. One walkthrough of four stages (machine, work, habits, extensions), questions after each, then one plan. A question about one topic (which hooks are slow) goes to that topic's skill; this session's tokens alone is `\u002Fqsm-usage`.","https:\u002F\u002Fgithub.com\u002Fqsmark-labs\u002Fqsm-marketplace\u002Fblob\u002Fmain\u002Fplugins\u002Fqsm-usage\u002Fskills\u002Fusage\u002FSKILL.md",[],[]]