This is a compilation-focused performance guide with 45 rules split across type system optimization, compiler config, and async patterns. It's most useful when you're dealing with slow tsc builds or need to configure tsconfig.json properly. The categorization by priority (type system and compiler settings marked CRITICAL, async and modules HIGH) makes it easy to know what actually matters. What stands out is the specificity: exact impact metrics like "30-50% faster declaration emit" for explicit return types or "50-90% faster rebuilds" for incremental compilation. If you're hunting down why your TypeScript build is slow or trying to prevent common footguns like barrel imports or deeply nested generics, this gives you concrete rules with measurable outcomes rather than vague best practices.

skills.sh installs
1.8K
GitHub stars
222
last updated
Aug 21, 2026

Install

$ npx -y skills add pproenca/dot-skills --skill typescript --agent claude-code

Installs into .claude/skills of the current project.

Files

TypeScript Best Practices

Comprehensive performance optimization guide for TypeScript applications. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

When to Apply

Reference these guidelines when:

  • Configuring tsconfig.json for a new or existing project
  • Writing complex type definitions or generics
  • Optimizing async/await patterns and data fetching
  • Organizing modules and managing imports
  • Reviewing code for compilation or runtime performance

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Type System PerformanceCRITICALtype-
2Compiler ConfigurationCRITICALtscfg-
3Async PatternsHIGHasync-
4Module OrganizationHIGHmodule-
5Type Safety PatternsMEDIUM-HIGHsafety-
6Memory ManagementMEDIUMmem-
7Runtime OptimizationLOW-MEDIUMruntime-
8Advanced PatternsLOWadvanced-

Table of Contents

Sponsors

Details

Repository
github.com/pproenca/dot-skills
Categories
Frontend Development, Testing & QA, Debugging
First seen
May 16, 2026

More from pproenca/dot-skills

All 100
1dylantarre avatarframer-motiondylantarre/animation-principlesUse when implementing Disney's 12 animation principles with Framer Motion in React applications1.8Kskills.sh installs
2k-dense-ai avatarxlsxk-dense-ai/scientific-agent-skillsCreate, edit, analyze, or convert Excel spreadsheets (.xlsx, .xlsm, .xltx) where the workbook file is the primary deliverable. Use for formulas, formatting, fin1.8Kskills.sh installs
3jezweb avatarvitestjezweb/claude-skillsSet up Vitest testing in any project — detects type (Cloudflare Workers, React, Node, library), generates vitest.config.ts, test setup, utilities, and a sample 1.8Kskills.sh installs
4ar9av avatarwiki-dedupar9av/obsidian-wikiScan the Obsidian wiki for page-level identity collisions — different pages covering the same concept under different names (e.g. "RSC" vs "React Server Compone1.8Kskills.sh installs
5mindrally avatarhtmxmindrally/skillsHTMX development guidelines for building dynamic web applications with minimal JavaScript using HTML attributes.1.7Kskills.sh installs
6answerzhao avatarweb-readeranswerzhao/agent-skillsImplement web page content extraction capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to scrape web pages, extract article content, 1.7Kskills.sh installs