typescript-expert

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill typescript-expert-alex-jordan547
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typescript-expert
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/2026-09-10/typescript-expert
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill typescript-expert-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? TypeScript projects often hit cryptic compiler errors, slow type checking, module resolution failures, and painful JavaScript-to-TypeScript migrations. This Skill provides expert-level guidance and diagnostics to identify root causes and apply proven fixes. ## Core Features & Use Cases - Type-Level Programming Guidance: Apply branded types, conditional types, template literal types, and type inference patterns for complex domain modeling. - Performance Diagnostics: Run the included diagnostic script to analyze tsconfig settings, detect 'any' usage, measure type-check time, and detect monorepo tooling. - Migration & Tooling Decisions: Get decision matrices for Biome vs ESLint, Nx vs Turborepo, and step-by-step JS-to-TS migration strategies. - Use Case: Your build suddenly fails with 'Type instantiation is excessively deep'. Invoke this Skill to diagnose the recursive type, apply a depth-limited fix, and validate with tsc --noEmit. ## Quick Start Ask the agent to diagnose why my TypeScript project fails type checking and fix the errors using the typescript-expert approach.

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 generic types. Fix it by limiting recursion depth with conditional types, replacing type intersections with interfaces, or splitting large union types. The Skill includes concrete code patterns for each fix.

How do I speed up slow TypeScript type checking?

Enable skipLibCheck and incremental compilation, configure precise include/exclude patterns, and use project references with composite: true in monorepos. Run tsc --extendedDiagnostics to measure check time and identify bottlenecks.

Biome vs ESLint: which should I use for TypeScript?

Choose Biome when speed is critical and you want one tool for linting and formatting in a TypeScript-first project. Stay with ESLint when you need type-aware linting, custom rules, or Vue/Angular support, which Biome lacks.

How do I migrate a JavaScript project to TypeScript incrementally?

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

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

Module resolution failures usually come from a moduleResolution setting that mismatches your bundler, misaligned baseUrl and paths, or stale caches. Check tsconfig settings first, then clear node_modules/.cache and .tsbuildinfo files.

When should I use branded types in TypeScript?

Use branded types for critical domain primitives like UserId or OrderId where mixing plain strings would cause bugs. They create nominal typing at compile time with zero runtime cost, preventing accidental argument swaps at API boundaries.