writing-typescript
Imported from alexei-led/cc-thingz/dist/claude/programming/skills/writing-typescript.
Install
npx skills add https://github.com/alexei-led/cc-thingz/tree/master/dist/claude/programming/skills/writing-typescript
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alexei-led-cc-thingz@llmmart
git clone https://github.com/alexei-led/cc-thingz.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alexei-led/cc-thingz collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
TypeScript Development
Follow the repository's TypeScript version, tsconfig, package manager, framework, and test runner. In a monorepo, work from the nearest package.json and tsconfig.json and name the package you chose.
Defaults
- Never weaken compiler options to pass a check. New configs enable
strict,noUncheckedIndexedAccess,exactOptionalPropertyTypes,useUnknownInCatchVariables,noImplicitOverride, andnoFallthroughCasesInSwitch. - Treat HTTP responses, JSON, env, storage, form data, and SDK output as
unknown. Narrow at the boundary with the project's schema library or a small type guard; never castawait res.json()to a domain type. - Avoid
any,ascasts, non-null!, and broad index signatures unless a runtime check or an external type gap justifies them. - Discriminated unions for variants and async state, with an exhaustive
nevercheck. Literal unions oras constarrays instead of new enums.satisfiesfor config maps. - Result unions for recoverable failures callers must branch on; throw
Errorinstances otherwise. - Pass dependencies as parameters; no singletons or hidden module state. Thread
AbortSignalthrough work that can outlive its caller. - Ask before adding a schema, form, query, or state library the project does not already use.
React
- Plain function components, not
React.FC. TypechildrenasReactNode. - Derive state during render. Fix stale closures instead of suppressing exhaustive-deps.
- Add
memo,useMemo, oruseCallbackonly for measured cost or a real identity need. - Validate fetched data in the fetcher, not in render. Custom hooks throw when their provider is missing.
Tooling
Typecheck with the project script or tsc --noEmit. Use one formatter and one linter per file; the selection order is in linting.md.
References
- testing.md: read when adding or changing tests, including React component tests.
- linting.md: read when choosing a formatter or linter, changing lint config, or diagnosing slow lint.
Done when the relevant build/test/lint checks pass on what you changed, or you name each check that did not run and why.
Files (cc-thingz)
-
references
-
linting.md 1.7 KB
Loading… -
testing.md 1.2 KB
Loading…
-
-
SKILL.md 2.7 KB
--- {"agent":"engineer","allowed-tools":["Read","Bash","Grep","Glob","Edit","Write","LS"],"context":"fork","description":"Idiomatic TypeScript development. Use when writing TypeScript code, Node.js services, React apps, or TypeScript design advice. Emphasizes strict typing, boundary validation, composition, fast feedback, behavior tests, and project-configured tooling. NOT for Go, Python, Rust, plain HTML/CSS/JS, or server-rendered templates (use writing-web).","name":"writing-typescript","user-invocable":false} --- # TypeScript Development Follow the repository's TypeScript version, tsconfig, package manager, framework, and test runner. In a monorepo, work from the nearest `package.json` and `tsconfig.json` and name the package you chose. ## Defaults - Never weaken compiler options to pass a check. New configs enable `strict`, `noUncheckedIndexedAccess`, `exactOptionalPropertyTypes`, `useUnknownInCatchVariables`, `noImplicitOverride`, and `noFallthroughCasesInSwitch`. - Treat HTTP responses, JSON, env, storage, form data, and SDK output as `unknown`. Narrow at the boundary with the project's schema library or a small type guard; never cast `await res.json()` to a domain type. - Avoid `any`, `as` casts, non-null `!`, and broad index signatures unless a runtime check or an external type gap justifies them. - Discriminated unions for variants and async state, with an exhaustive `never` check. Literal unions or `as const` arrays instead of new enums. `satisfies` for config maps. - Result unions for recoverable failures callers must branch on; throw `Error` instances otherwise. - Pass dependencies as parameters; no singletons or hidden module state. Thread `AbortSignal` through work that can outlive its caller. - Ask before adding a schema, form, query, or state library the project does not already use. ## React - Plain function components, not `React.FC`. Type `children` as `ReactNode`. - Derive state during render. Fix stale closures instead of suppressing exhaustive-deps. - Add `memo`, `useMemo`, or `useCallback` only for measured cost or a real identity need. - Validate fetched data in the fetcher, not in render. Custom hooks throw when their provider is missing. ## Tooling Typecheck with the project script or `tsc --noEmit`. Use one formatter and one linter per file; the selection order is in linting.md. ## References - [testing.md](references/testing.md): read when adding or changing tests, including React component tests. - [linting.md](references/linting.md): read when choosing a formatter or linter, changing lint config, or diagnosing slow lint. Done when the relevant build/test/lint checks pass on what you changed, or you name each check that did not run and why.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.