typescript-expert

Diagnose and resolve TypeScript type errors, build performance issues, and migration tasks.

3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/trudyan141/my-antigravity-agents-kit --skill typescript-expert-trudyan141
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typescript-expert
Source: https://github.com/trudyan141/my-antigravity-agents-kit/tree/main/templates/.agent/skills/typescript-expert
Command: npx skills add https://github.com/trudyan141/my-antigravity-agents-kit --skill typescript-expert-trudyan141

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? TypeScript projects often hit cryptic compiler errors, slow type checking, module resolution failures, and painful JavaScript-to-TypeScript or tooling migrations. This Skill provides expert-level guidance to diagnose and fix these issues using current best practices. ## Core Features & Use Cases - Advanced Type System Guidance: Apply branded types, conditional types, template literal types, and type inference techniques like satisfies and const assertions. - Performance Optimization: Diagnose slow type checking with --extendedDiagnostics, fix deep type instantiation, and configure skipLibCheck, incremental builds, and project references for monorepos. - Migration & Tooling Decisions: Plan incremental JS-to-TS migrations, choose between Biome and ESLint, Nx and Turborepo, and handle ESM/CJS interop. - Use Case: Your monorepo build suddenly fails with "Type instantiation is excessively deep". Invoke this Skill to trace the recursive type, apply a depth-limited pattern, and validate with tsc --noEmit. ## Quick Start Use the typescript-expert skill to diagnose why my project fails type checking with a deep type instantiation error and fix it.

Frequently Asked Questions about typescript-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix "Type instantiation is excessively deep" in TypeScript?

This error comes from deeply recursive or circular types. Fix it by limiting recursion depth with conditional types, replacing type intersections with interfaces, splitting large union types, and breaking circular generic constraints.

Biome vs ESLint: which should I use for TypeScript?

Use Biome when speed is critical and you want one tool for linting and formatting with TypeScript-first support. Stay with ESLint when you need specific plugins, custom rules, type-aware linting, or Vue/Angular support.

How do I speed up slow TypeScript type checking?

Run tsc with --extendedDiagnostics to find bottlenecks, then enable skipLibCheck and incremental builds, tighten include/exclude patterns, and use project references with composite: true in monorepos.

Why does TypeScript say "Cannot find module" when the file exists?

This usually means moduleResolution does not match your bundler, baseUrl or paths are misaligned, or a stale cache exists. Check your tsconfig settings and clear node_modules/.cache and .tsbuildinfo files.

How do I migrate a JavaScript project to TypeScript incrementally?

Enable allowJs and checkJs in tsconfig, rename files from .js to .ts gradually, add types file by file, then enable strict mode options one at a time. Tools like ts-migrate and typesync can automate parts of the process.

Do TypeScript path aliases work at runtime in Node.js?

No, tsconfig paths only apply at compile time. For Node.js runtime, use ts-node with tsconfig-paths/register, an ESM loader alternative, or pre-compile with resolved paths for production.