When should I use an interface versus a type?

According to these best practices, interfaces should be reserved for defining behavior contracts (like dependency injection), while types should be used for data structures and definitions.

Why does this skill prefer 'unknown' over 'any'?

The 'any' type disables type checking entirely, while 'unknown' forces the developer to perform type narrowing or assertions, maintaining strict type safety throughout the application.

How does the skill handle function parameters?

It enforces the 'options object' pattern for functions with 3 or more parameters to improve readability and prevent errors associated with positional arguments, especially booleans.

What is schema-first development in this context?

It is a pattern where you define validation schemas first and derive your TypeScript types from those schemas (e.g., using z.infer), ensuring that data entering your app at runtime matches your compile-time types.

TypeScript Best Practices

Name: TypeScript Best Practices
Author: mintuz

bymintuz

•

開発者ツール

Outputs strict, schema-first, and production-ready TypeScript code emphasizing type safety and immutability.

This skill optimizes Claude for high-quality TypeScript development by enforcing a schema-first approach where types are derived from validation schemas. It prioritizes runtime safety at trust boundaries, strict immutability, and explicit type definitions to eliminate technical debt and runtime errors. Whether building web APIs, mobile apps, or complex frontend systems, it provides a comprehensive framework for writing clean, maintainable code using modern patterns like branded types, options objects, and result-based error handling.

主な機能

01Strict immutability enforcement using readonly modifiers and spread patterns

0214 GitHub stars

03Elimination of 'any' types in favor of 'unknown' and explicit contracts

04Schema-first development for guaranteed runtime-to-compile-time type safety

05Identification and validation of trust boundaries (APIs, user inputs, files)

06Standardized patterns for error handling using Result types and early returns

ユースケース

01Architecting type-safe API layers with automated schema validation

02Refactoring legacy JavaScript or loose TypeScript into strict, production-grade codebases

03Implementing complex domain logic using branded types to prevent primitive obsession

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mintuz/claude-plugins skills

For use in Claude.ai and ChatGPT

Download Skill