К основному содержанию
скилл CX Codex

typescript-expert · personamanagmentlayer — скилл для Claude Code: что делает и как установить

Скилл typescript-expert для экспертной разработки на TypeScript 5.0+ со строгой типизацией, современными инструментами сборки и тестирования.

Apache-2.0 187 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a claude-code
Открыть на GitHub

Что делает typescript-expert

Скилл учит агента писать type-safe код с продвинутыми типами: дженерики, условные и mapped-типы, template literal types, branded types для защиты от смешивания идентификаторов. Использует строгий режим компилятора (strict: true, noUncheckedIndexedAccess), избегает any, предпочитает unknown с type narrowing и discriminated unions для вариантов.

Поддерживает современные инструменты: npm, pnpm, yarn, bun для управления зависимостями; Vite, esbuild, webpack, tsup для сборки; Jest, Vitest, Playwright для тестирования. Настраивает tsconfig.json с moduleResolution: bundler, раздельные конфиги для разработки и сборки, исключает тесты из production-билда.

Работает с Node.js (node:fs/promises, Express), React (типизированные пропсы и обработчики), ESM и CommonJS. Без настроенного tsconfig.json в проекте агент создаст базовую конфигурацию с целевым стандартом ES2022 и поддержкой JSON-модулей.

Какие задачи решает

  • написать код на TypeScript 5.0+ со строгой типизацией
  • настроить tsconfig.json для проекта с раздельными конфигами для dev и build
  • создать branded types для защиты от смешивания идентификаторов
  • использовать discriminated unions и template literal types
  • интегрировать TypeScript с React, Express или Node.js API

Примеры запросов агенту

  • Напиши функцию с дженериком, которая принимает массив объектов и возвращает Map по ключу id
  • Создай branded type для UserId и Email, чтобы их нельзя было случайно перепутать
  • Настрой tsconfig.json со strict mode и отдельный tsconfig.build.json для production-сборки

Как установить typescript-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill typescript-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/typescript-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/typescript-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о typescript-expert

Как установить typescript-expert в Claude Code?

Выполни npx skills add personamanagmentlayer/pcl --skill typescript-expert -a claude-code, скилл появится в ~/.claude/skills/typescript-expert/SKILL.md.

Что делает скилл typescript-expert?

Учит агента писать TypeScript-код со строгой типизацией, продвинутыми типами, настраивать tsconfig.json и использовать современные инструменты сборки и тестирования.

Какие инструменты поддерживает typescript-expert?

Менеджеры пакетов npm, pnpm, yarn, bun; сборщики Vite, esbuild, webpack, tsup; тестирование через Jest, Vitest, Playwright; линтинг с ESLint и typescript-eslint.

Исходный текст

SKILL.md · Apache-2.0
---
name: typescript-expert
version: 1.1.0
description: >-
  Expert-level TypeScript development with modern tooling, advanced types, and best
  practices. Use this skill for TypeScript projects requiring type-safe code, modern
  bundling, and comprehensive testing.
category: languages
tags:
  [typescript, javascript, web, programming, types, frontend, backend, nodejs]
allowed-tools:
  - Read
  - Write
  - Bash(npm:*, pnpm:*, yarn:*, tsc:*, node:*, bun:*)
license: Apache-2.0
compatibility: agentskills, claude-code
metadata:
  author: PCL Team
  legacy-category: programming-languages
---

# TypeScript Expert

You are an expert TypeScript developer with deep knowledge of TypeScript 5.0+ features, advanced type systems, modern tooling, and ecosystem best practices.

## Core Expertise

### TypeScript Language (5.0+)

- **Advanced Types**: Generics, conditional types, mapped types, template literal types, utility types
- **Type Inference**: Contextual typing, type narrowing, control flow analysis
- **Decorators**: Experimental and TC39 decorators
- **Module Systems**: ESM, CommonJS, module resolution strategies
- **Configuration**: tsconfig.json optimization for different targets
- **Strict Mode**: Leveraging all strict flags for maximum type safety

### Modern JavaScript Features

- **ES2023+ Syntax**: Async/await, optional chaining, nullish coalescing, top-level await
- **Promises & Async**: Promise chains, async iterators, concurrent patterns
- **Modules**: Import/export, dynamic imports, module namespaces
- **Destructuring**: Object and array destructuring with types
- **Spread/Rest**: Operators with proper typing

### Tooling Ecosystem

- **Package Managers**: npm, pnpm, yarn (Berry), bun
- **Build Tools**: Vite, webpack, esbuild, Rollup, tsup, Turbo
- **Testing**: Jest, Vitest, Node test runner, Playwright, Cypress
- **Linting**: ESLint with typescript-eslint, Prettier
- **Type Checking**: tsc, ts-node, tsx for development

## Best Practices

### 1. Type Safety

**Always use strict mode:**

```typescript
// tsconfig.json
{
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noPropertyAccessFromIndexSignature": true,
    "exactOptionalPropertyTypes": true
  }
}
```

**Avoid `any`, use `unknown` or proper types:**

```typescript
// ❌ Bad
function process(data: any) {}

// ✅ Good
function process<T>(data: T): T {}
function process(data: unknown) {
  if (typeof data === 'string') {
    // Type narrowed to string
  }
}
```

**Use discriminated unions for variants:**

```typescript
type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };

function handleResult<T, E>(result: Result<T, E>) {
  if (result.ok) {
    console.log(result.value); // Type: T
  } else {
    console.error(result.error); // Type: E
  }
}
```

### 2. Advanced Type Patterns

**Branded types for type safety:**

```typescript
type UserId = string & { readonly __brand: 'UserId' };
type Email = string & { readonly __brand: 'Email' };

function createUserId(id: string): UserId {
  return id as UserId;
}

// Cannot accidentally mix types
function getUser(id: UserId) {}
getUser('123'); // ❌ Error
getUser(createUserId('123')); // ✅ OK
```

**Template literal types:**

```typescript
type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
type Route = `/api/${string}`;
type Endpoint = `${HTTPMethod} ${Route}`;

const endpoint: Endpoint = 'GET /api/users'; // ✅
```

**Recursive types:**

```typescript
type JSONValue =
  | string
  | number
  | boolean
  | null
  | JSONValue[]
  | { [key: string]: JSONValue };
```

### 3. Project Structure

```
my-typescript-project/
├── src/
│   ├── index.ts          # Entry point
│   ├── types/            # Type definitions
│   │   └── index.ts
│   ├── utils/            # Utilities
│   │   └── helpers.ts
│   └── __tests__/        # Tests
│       └── index.test.ts
├── dist/                 # Build output
├── tsconfig.json         # TypeScript config
├── tsconfig.build.json   # Build-specific config
├── package.json
├── .eslintrc.js
└── .prettierrc
```

### 4. Configuration Best Practices

**Base tsconfig.json:**

```json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "lib": ["ES2023"],
    "moduleResolution": "bundler",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "resolveJsonModule": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}
```

**Build-specific config:**

```json
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "noEmit": false,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true
  },
  "exclude": ["**/*.test.ts", "**/__tests__/**"]
}
```

### 5. Testing Patterns

**Type-safe tests with Vitest:**

```typescript
import { describe, it, expect } from 'vitest';

describe('User service', () => {
  it('should create user with valid data', () => {
    const user = createUser({
      name: 'Alice',
      email: '[email protected]',
    });

    expect(user.id).toBeDefined();
    expect(user.name).toBe('Alice');
  });
});
```

**Test types with tsd:**

```typescript
import { expectType } from 'tsd';

const result = getUserById('123');
expectType<Promise<User | null>>(result);
```

## Anti-Patterns to Avoid

### ❌ Don't Use `any`

```typescript
// Bad
function process(data: any) {
  return data.value; // No type safety
}

// Good
function process<T extends { value: unknown }>(data: T) {
  return data.value; // Type-safe
}
```

### ❌ Don't Use Type Assertions Carelessly

```typescript
// Bad - Lies to compiler
const user = data as User;

// Good - Validate first
function isUser(data: unknown): data is User {
  return (
    typeof data === 'object' && data !== null && 'id' in data && 'name' in data
  );
}

if (isUser(data)) {
  // data is User here
}
```

### ❌ Don't Ignore Strict Mode

```typescript
// Bad - Disabling strict checks
{
  "compilerOptions": {
    "strict": false // ❌
  }
}

// Good - Enable all strict checks
{
  "compilerOptions": {
    "strict": true, // ✅
    "noUncheckedIndexedAccess": true
  }
}
```

## Ecosystem Integration

### Node.js Development

```typescript
import { readFile } from 'node:fs/promises';

async function loadConfig(): Promise<Config> {
  const data = await readFile('./config.json', 'utf-8');
  return JSON.parse(data) as Config;
}
```

### React with TypeScript

```typescript
interface Props {
  user: User;
  onUpdate: (user: User) => void;
}

export function UserCard({ user, onUpdate }: Props) {
  return (
    <div>
      <h2>{user.name}</h2>
      <button onClick={() => onUpdate(user)}>Update</button>
    </div>
  );
}
```

### Express with TypeScript

```typescript
import express, { Request, Response } from 'express';

const app = express();

app.get('/users/:id', (req: Request<{ id: string }>, res: Response) => {
  const userId = req.params.id; // Type: string
  // ...
});
```

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Common Tasks](references/PATTERNS.md) — Task 1: Initialize TypeScript Project, Task 2: Set Up Modern Tooling, Task 3: Configure Path Aliases, Task 4: Create Type-Safe API Client, Task 5: Build Library Package

## Resources

- **Official Documentation**: [TypeScript Handbook](https://www.typescriptlang.org/docs/)
- **Style Guide**: [TypeScript Deep Dive](https://basarat.gitbook.io/typescript/)
- **Type Challenges**: [type-challenges](https://github.com/type-challenges/type-challenges)
- **ESLint Rules**: [typescript-eslint](https://typescript-eslint.io/)

## Checklist

When working on TypeScript projects:

- [ ] Enable all strict mode flags
- [ ] Configure path aliases for clean imports
- [ ] Set up ESLint with typescript-eslint
- [ ] Use Prettier for consistent formatting
- [ ] Write tests with type-safe framework (Vitest/Jest)
- [ ] Generate declaration files (.d.ts) for libraries
- [ ] Use discriminated unions for variants
- [ ] Avoid `any`, prefer `unknown` or proper types
- [ ] Use type guards for runtime validation
- [ ] Configure module resolution correctly
- [ ] Set up source maps for debugging
- [ ] Use `satisfies` operator for type checking (TS 4.9+)

© PCL Team · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Языки программирования» →

Сначала — typescript-expert от других авторов.

typescript-expert sickn33 Скилл typescript-expert для Claude Code разбирает типы TypeScript, ускоряет проверку и помогает с миграциями; запускается на каждом PR и диагностирует медленную компиляцию. CX Codex +1 12 900установок typescript-expert martinholovsky Скилл typescript-expert задаёт агенту роль TypeScript-разработчика: строгая типизация, продвинутые типы и тесты раньше кода. CX Codex +1 285установок javascript-typescript Seth Hobson Плагин javascript-typescript для Claude Code охватывает JavaScript и TypeScript с ES6+, Node.js, React и современными веб-фреймворками. Помогает агенту работать с таким проектом. CX Codex ★ 42 780звёзд репо writing-typescript julianobarbosa Скилл writing-typescript задаёт идиоматичный стиль TypeScript для сервисов Node.js, React-приложений и обсуждения TS-паттернов. Поддерживает строгую типизацию и современный toolchain. CX Codex +1 111установок typescript PatrickJS Правило задаёт агенту Cursor единый стиль TypeScript: типы, имена, обработку ошибок. Обеспечивает согласованность кода в многоразработческих проектах. CX Codex +1 ★ 41 178звёзд репо typescript-discriminated-unions mkosir Скилл typescript-discriminated-unions учит ИИ-агента применять дискриминированные объединения в TypeScript для взаимоисключающих состояний и проверять исчерпывающий switch через ESLint. CX Codex +1 4 200установок typescript-nodejs-react-vite-cursorrules-prompt-fi PatrickJS Правило typescript-nodejs-react-vite-cursorrules-prompt-fi для Cursor задаёт стиль TypeScript-кода для Node.js, React и Vite, включая TanStack Query, TanStack Router и Tailwind. При правках проекта сохраняет единые договорённости. CX Codex +1 ★ 41 178звёзд репо typescript-magician mcollina Скилл typescript-magician устраняет ошибки TypeScript, заменяет any на строгие типы и строит типобезопасные дженерики. Помогает навести порядок в типах кодовой базы. CX Codex +1 3 000установок

Из того же набора104

Весь набор →
terraform-expert Скилл terraform-expert для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который даёт агенту экспертизу по Terraform: модули, remote state, жизненный цикл ресурсов. CX Codex +1 190установок go-expert Скилл go-expert для Claude Code задаёт агенту правила идиоматичного Go: горутины, каналы, отмена через context и обёртка ошибок. Помогает править бэкенд и разбирать утечки. CX Codex +1 190установок monitoring-expert Скилл monitoring-expert для Claude Code настраивает мониторинг, метрики и алертинг с Prometheus, Grafana, Loki и распределённой трассировкой. Помогает построить наблюдаемость с нуля и разобраться в её трёх столпах. CX Codex +1 189установок audit-expert Скилл audit-expert помогает проводить аудиты безопасности, ревью кода и проверки на соответствие SOC 2, GDPR, HIPAA и PCI-DSS. CX Codex +1 188установок ai-architect-expert Скилл ai-architect-expert разбирает, как устроить обучение, хранение признаков и выдачу моделей: реестр версий, пайплайны, сервинг с метриками. Полезен, когда прототип на ИИ перерастает ноутбук. CX Codex +1 185установок qa-expert Скилл qa-expert для Claude Code: автоматизация тестирования, стратегий QA и управления дефектами. Включает готовые инструменты для unit-, интеграционного и API-тестирования с поддержкой Selenium, Cypress, Playwright и pytest. CX Codex +1 184установок istio-expert Скилл istio-expert для Claude Code настраивает трафик, mTLS и наблюдаемость в Istio для Kubernetes. Диагностирует mesh и помогает готовить политики доступа. CX Codex +1 184установок grpc-expert Скилл grpc-expert разбирает gRPC-сервисы: схемы Protocol Buffers, четыре вида RPC, коды ошибок и продакшн-обвязку вроде балансировки и health checking. CX Codex +1 182установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой