typescript-refactoring-patterns
Expert TypeScript refactoring patterns for cleaner, type-safe code
How do I install this agent skill?
npx skills add https://github.com/autohandai/community-skills --skill typescript-refactoring-patternsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides expert TypeScript refactoring patterns and best practices. It is rated as LOW risk due to the inherent indirect prompt injection surface associated with tools that read and modify external source code, although no malicious behavior was detected within the skill content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
TypeScript Refactoring Patterns
Core Principles
- Type Narrowing Over Type Assertions - Use type guards and discriminated unions instead of
ascasts - Const Assertions for Literals - Use
as constfor immutable literal types - Generic Constraints - Prefer
extendsconstraints overany - Branded Types - Use branded types for domain-specific validation
Refactoring Patterns
Extract Discriminated Union
When you see multiple boolean flags, refactor to discriminated union:
// Before
interface User {
isAdmin: boolean;
isGuest: boolean;
permissions?: string[];
}
// After
type User =
| { role: 'admin'; permissions: string[] }
| { role: 'guest' }
| { role: 'member'; permissions: string[] };
Replace Conditional with Polymorphism
When you see switch statements on type, use the strategy pattern:
// Before
function process(item: Item) {
switch (item.type) {
case 'a': return processA(item);
case 'b': return processB(item);
}
}
// After
const processors: Record<ItemType, (item: Item) => Result> = {
a: processA,
b: processB,
};
const process = (item: Item) => processors[item.type](item);
Extract Type Guard
When narrowing types, create reusable type guards:
function isNonNullable<T>(value: T): value is NonNullable<T> {
return value !== null && value !== undefined;
}
// Usage
const items = array.filter(isNonNullable);
Use Branded Types for Validation
Prevent primitive obsession with branded types:
type UserId = string & { readonly brand: unique symbol };
type Email = string & { readonly brand: unique symbol };
function createUserId(id: string): UserId {
if (!isValidUuid(id)) throw new Error('Invalid user ID');
return id as UserId;
}
Code Smell Detectors
Watch for these patterns and refactor:
anytypes (replace withunknown+ type guards)- Non-null assertions
!(add proper checks) - Type assertions
as(use type guards) - Optional chaining abuse
?.?.?.(restructure data) - Index signatures without validation
Quick Wins
- Enable
strict: truein tsconfig - Use
satisfiesfor type checking without widening - Prefer
readonlyarrays and objects - Use
unknownfor external data, validate at boundaries
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/autohandai/community-skills/typescript-refactoring-patterns">View typescript-refactoring-patterns on skillZs</a>