skills.rest
gonzoblasco
gonzoblascoCOMMUNITY
Explore all skills by this author →
𝕏@gonzoblascoGitHub

typescript-expert

Diagnose and resolve TypeScript type errors, compiler performance issues, and migration challenges.

1|Updated Jul 20, 2026
Search Tags:#typescript#debugging#migration#type checking#monorepo#tsconfig#compiler performance
One-click install
npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill typescript-expert-gonzoblasco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: typescript-expert
Source: https://github.com/gonzoblasco/ai-developer-stack/tree/main/languages-standards/typescript-expert
Command: npx skills add https://github.com/gonzoblasco/ai-developer-stack --skill typescript-expert-gonzoblasco

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 systematic diagnostic workflows, type-level programming patterns, and tooling decision trees to resolve these issues without guesswork. ## Core Features & Use Cases - Type-Level Programming Guidance: Apply branded types, conditional types, template literal types, and controlled recursion to model domains safely and avoid "type instantiation excessively deep" errors. - Compiler Performance Diagnostics: Run the included ts_diagnostic.py script or tsc flags like --extendedDiagnostics and --traceResolution to find slow type checking, misconfigured tsconfig files, and module resolution failures. - Migration & Tooling Decisions: Follow incremental JS-to-TS migration steps, strict tsconfig templates, and decision matrices for Biome vs ESLint and Nx vs Turborepo. - Use Case: Your monorepo's editor takes 30 seconds to show type errors. Use this Skill to run extended diagnostics, enable skipLibCheck and project references, and cut check time dramatically. ## Quick Start Ask the AI to diagnose your TypeScript project's type errors and compiler performance using the typescript-expert skill.

Frequently Asked Questions about typescript-expert

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

FAQPage Schema
How do I fix slow TypeScript type checking in a large project?▼

Run npx tsc --extendedDiagnostics to measure check time, then enable skipLibCheck and incremental compilation in tsconfig. For monorepos, configure project references with composite: true, and replace type intersections with interfaces to reduce instantiation depth.

How do I fix "type instantiation is excessively deep" errors?▼

This error comes from circular or deeply recursive types. Limit recursion depth with conditional types, prefer interface extends over type intersections, split union types with more than 100 members, and simplify generic constraints.

Should I use Biome or ESLint for a TypeScript project?▼

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 support for Vue and Angular, which Biome handles poorly.

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 mean moduleResolution does not match your bundler, baseUrl and paths are misaligned, or caches are stale. Run npx tsc --traceResolution to trace lookups and clear node_modules/.cache and .tsbuildinfo files.

What are branded types in TypeScript and when should I use them?▼

Branded types intersect a primitive with a unique brand tag to create nominal types like UserId or OrderId, preventing accidental mixing of domain primitives. Use them at API boundaries, for currency or unit values, and for critical domain identifiers.

Related Skills

Explore More Software Engineering Skills→
open-haxopen-hax
6

testing-typescript-ava

Set up Ava test runner for TypeScript projects with minimal configuration.

Official
Intermediate
BenWork17BenWork17

code-review-checklist

Automates code-review checklists for correctness, security, performance, quality, testing, and documentation.

Community
Intermediate
travisjneumantravisjneuman
88

test-specialist

Write unit, integration, and end-to-end tests for JavaScript/TypeScript applications.

Community
Advanced
orient-botorient-bot

esm-cjs-interop

Analyze ESM/CJS import patterns and circular dependencies in a monorepo.

Official
Intermediate