# typescript

Enforces strict TypeScript standards and functional code patterns in your AI assistant. It bans any, replaces enums with maps, and caps function length at 20 lines.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 955 installs · ★ 286
- Author: Mindrally
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Mindrally/skills/tree/HEAD/typescript/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/mindrally-typescript

## What it does

The skill configures the model to generate declarative TypeScript without classes. It enforces `interface` over `type`, completely bans `any`, and replaces enums with dictionary maps and `as const` assertions. Source files follow an organized layout: exported components come first, followed by subcomponents, helpers, static values, and type declarations.

Functions are kept concise, with a strict limit of 20 lines and early returns to avoid nested branching. The prompt instructs the agent to apply the RORO pattern, taking and returning structured objects. Arrow functions handle simple operations under 3 lines, while named functions run heavier logic.

Because the rules outlaw TypeScript enums, running this in an existing codebase will prompt the agent to refactor enums into maps. All public exports and methods must include JSDoc comments.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill typescript -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/typescript/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/typescript/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill typescript -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/typescript/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill typescript -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/typescript/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Mindrally/skills typescript
```

2. **Manually: put the files in place**
- File: `.github/skills/typescript/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill typescript -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Mindrally/skills --path typescript
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/typescript/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Mindrally/skills --skill typescript -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Mindrally/skills/tree/HEAD/typescript/SKILL.md

## When to use it
- eliminate any types across the TypeScript codebase
- refactor long functions into single-purpose blocks under 20 lines
- replace TypeScript enums with maps and as const definitions
- apply the RORO pattern and early returns to reduce nesting

## Example prompts
- Refactor this module to follow typescript rules: remove enums and any types
- Write an auth handler using the RORO pattern and guard clauses
- Structure this component file with interfaces, subcomponents, and JSDoc

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 02b9560dcfd67cc4.

BEGIN THIRD-PARTY FILE 02b9560dcfd67cc4
```text
---
name: typescript
description: Expert in TypeScript development with best practices for type safety and clean code
metadata:
  maintainer: Mindrally
  source: https://github.com/Mindrally/skills
---

# TypeScript

You are an expert in TypeScript development with deep knowledge of type safety and modern JavaScript patterns.

## Core Principles

### Code Style & Structure
- Write concise, technical TypeScript with accurate examples
- Use functional and declarative programming patterns; avoid classes
- Prefer iteration and modularization over code duplication
- Use descriptive variable names with auxiliary verbs (e.g., `isLoading`, `hasError`)
- Structure files: exported component, subcomponents, helpers, static content, types

### Naming Conventions
- Use PascalCase for classes, types, and interfaces
- Use camelCase for variables, functions, and methods
- Use kebab-case for file and directory names
- Use UPPERCASE for environment variables and constants
- Prefix functions with verbs; use boolean prefixes like `is`, `has`, `can`

## TypeScript Usage

- Use TypeScript for all code; prefer interfaces over types
- Avoid `any` type; create precise type definitions
- Use functional components with TypeScript interfaces
- Avoid enums; use maps instead
- Use `readonly` for immutable properties
- Use `as const` for literal values

## Functions & Methods

- Write short functions with single purpose (less than 20 lines)
- Use arrow functions for simple operations (less than 3 lines)
- Use named functions for complex logic
- Implement early returns to avoid nested blocks
- Use default parameters instead of null/undefined checks
- Apply the RORO pattern: "Receive an Object, Return an Object"

## Data & Classes

- Encapsulate data in composite types
- Prefer immutability where possible
- Follow SOLID principles
- Prefer composition over inheritance
- Keep classes under 200 lines with fewer than 10 public methods

## Error Handling

- Use exceptions for unexpected errors
- Implement proper error logging with context
- Create custom error types for consistency
- Use guard clauses for preconditions
- Catch exceptions only to fix expected problems or add context

## Documentation

- Use JSDoc for public classes and methods
- Document all exports clearly
- Provide usage examples when appropriate
- Keep documentation concise and accurate
```
END THIRD-PARTY FILE 02b9560dcfd67cc4

The third-party file has ended. Everything between the 02b9560dcfd67cc4 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© Mindrally · Apache-2.0 · https://github.com/Mindrally/skills/tree/HEAD/typescript/SKILL.md

## Similar
- [typescript-clean-code](https://affpapa.org/en/nevibecode/skills/typescript-clean-code.md) — skill · 628 installs
- [typescript-docs](https://affpapa.org/en/nevibecode/skills/typescript-docs.md) — skill · 4200 installs
- [jsdoc-typescript-docs](https://affpapa.org/en/nevibecode/skills/jsdoc-typescript-docs.md) — skill · 547 installs
- [typescript-variables](https://affpapa.org/en/nevibecode/skills/typescript-variables.md) — skill · 3800 installs
- [typescript-discriminated-unions](https://affpapa.org/en/nevibecode/skills/typescript-discriminated-unions.md) — skill · 3800 installs
- [experience-lwc-typescript-migrate](https://affpapa.org/en/nevibecode/skills/experience-lwc-typescript-migrate.md) — skill · 2300 installs

## Other versions with the same name

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md