expert-typescript-programmer
Write, refactor, or review TypeScript code with strict, precise, maintainable types and without unnecessary `any`, type assertions, or type suppressions. Use when working on `.ts` or `.tsx` files, public APIs, generics, discriminated unions, type guards, tsconfig/module settings, declaration-facing code, or any change where TypeScript type quality affects correctness in the Remix repo.
Best for Remix repository developmentWorks with GitHubLow risk
⌘source
- author
@remix-run- repo
- remix-run/remix
- language
- TypeScript
★33kstars
2.8kforks
Apr 23, 2026
✦overview.md
Key Features
- ·Enforces strict, precise TypeScript types without unnecessary 'any'
- ·Models runtime contracts before implementing types
- ·Validates external data at boundaries before type assignment
- ·Runs type checking and testing commands before completion
- ·Uses type-only imports/exports for cleaner builds
Use Cases
- →Refactoring existing TypeScript code to eliminate type assertions and suppressions
- →Writing new TypeScript components with maintainable type definitions
- →Reviewing TypeScript changes in public APIs or declaration-facing code
- →Working with generics, discriminated unions, or complex type guards
Best for
- ✓Remix repository development
- ✓TypeScript library maintainers
- ✓Teams prioritizing type safety
Not ideal for
- !Quick prototyping without type rigor
- !Non-TypeScript JavaScript projects
- !One-off scripts where type precision isn't critical
FAQs
name
expert-typescript-programmer
description
Write, refactor, or review TypeScript code with strict, precise, maintainable types and without unnecessary `any`, type assertions, or type suppressions. Use when working on `.ts` or `.tsx` files, public APIs, generics, discriminated unions, type guards, tsconfig/module settings, declaration-facing code, or any change where TypeScript type quality affects correctness in the Remix repo.
Expert TypeScript Programmer
Overview
Use this skill to write TypeScript that is simple at runtime and precise at compile time. Prefer local repo conventions first, then apply the official TypeScript guidance summarized here.
Workflow
- Read the nearest
tsconfig.json, packagepackage.json, and relevant existing source before choosing types. - Model the runtime contract first: inputs, outputs, failure modes, ownership boundaries, and public API shape.
- Use TypeScript to make invalid states hard to represent, but keep the implementation readable JavaScript.
- Validate unknown external data at the boundary; do not pretend unvalidated data already matches an internal type.
- Run the narrowest meaningful validation command before finishing: package typecheck/test for package changes,
pnpm run typecheck:changedandpnpm run test:changedfor broader changes, andpnpm run lintwhen practical.
Repo Rules
- Use
import type { X }andexport type { X }for type-only symbols. - Include
.tsextensions in relative imports and exports, matching this repo'sallowImportingTsExtensions/rewriteRelativeImportExtensionssetup.
$install
1-click copynpx skills add remix-run/remix --skill expert-typescript-programmerSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.