typescript-expert

Diagnose TypeScript type-level errors and tooling configuration issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill typescript-expert-joaopedroamaral
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typescript-expert
Source: https://github.com/JoaoPedroAmaral/backBarbearia/tree/main/.claude/skills/typescript-expert
Command: npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill typescript-expert-joaopedroamaral

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides deep, practical guidance to resolve complex TypeScript and JavaScript type-level issues, build and tooling configuration problems, and migration or monorepo pains that cause slow compilation, fragile types, or runtime module resolution errors.

Core Features & Use Cases

  • Type system mastery: Diagnose and refactor complex conditional, recursive, and branded types to reduce compiler instantiation depth and improve inference.
  • Performance & build optimization: Recommend tsconfig and build settings (skipLibCheck, incremental, project references) and advise on bundler/tooling trade-offs for faster type-check and build times.
  • Migration & monorepo strategy: Plan incremental JS→TS migrations, workspace path/runtime resolution fixes, and monorepo project references with concrete validation steps.
  • Use Case: Inspect a repository to find type errors, propose tsconfig and path fixes, and produce one-shot diagnostics and suggested code changes to restore fast, correct type-checking.

Quick Start

Analyze this repository for TypeScript type errors, tsconfig and path-mapping issues, monorepo or tooling misconfigurations, and propose concrete fixes with one-shot tsc diagnostics.

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 compilation in a monorepo?

Fix slow TypeScript compilation by analyzing tsconfig settings to recommend project references, incremental builds, and skipLibCheck. This optimizes type-checking and build times by resolving tooling misconfigurations and validating outcomes with one-shot tsc diagnostics.

What is the best way to plan a JavaScript to TypeScript migration?

Planning a JavaScript to TypeScript migration involves suggesting incremental migration steps and validating outcomes using one-shot tsc diagnostics. This approach ensures type safety is restored progressively without breaking existing runtime module resolution.

How do I resolve complex TypeScript type-level errors and compiler instantiation depth issues?

Resolve complex TypeScript type-level errors by diagnosing and refactoring conditional, recursive, and branded types. This reduces compiler instantiation depth and improves type inference, restoring correct type-checking.

Can I use this to fix runtime module resolution errors in a monorepo?

Yes, you can fix runtime module resolution errors in a monorepo by inspecting workspace path mappings and tsconfig settings. It performs static configuration analysis to propose concrete fixes that restore correct path and runtime resolution.

Why does my TypeScript build fail with fragile types and tooling misconfigurations?

TypeScript builds fail with fragile types due to complex type-level issues and tooling misconfigurations. Static configuration analysis identifies tsconfig path mapping errors and proposes code changes validated by one-shot tsc diagnostics to restore correctness.