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

writing-typescript — скилл для Claude Code: что делает, установка

Скилл writing-typescript задаёт идиоматичный стиль TypeScript для сервисов Node.js, React-приложений и обсуждения TS-паттернов. Поддерживает строгую типизацию и современный toolchain.

MIT 111 установок ★ 17 обновлён 2026-10-14

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

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

writing-typescript задаёт правила для TypeScript-кода: строгая типизация, unknown вместо any, разбор непроверенных данных на границах системы и композиция небольших функций вместо наследования. Он пригодится при разработке сервисов Node.js, React-приложений и при обсуждении паттернов TypeScript.

В скилле есть примеры type guards, discriminated unions и utility types, а также настройки tsconfig.json для строгого режима. Он ориентируется на bun, vite, vitest, eslint и prettier; команды проекта включают bun install, bun run build, bun test, bun run lint и bun run format.

Есть отдельные подсказки по import type, as const, satisfies, Array<T>.includes и наследованию настроек compilerOptions.paths. Если оставить strictNullChecks: false, типы перестают честно описывать null и undefined.

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

  • писать TypeScript с включёнными строгими проверками
  • разбирать непроверенные данные на границах приложения
  • выбирать между as, satisfies и as const
  • настраивать tsconfig.json для сборки и проверок
  • строить типы через объединения и utility types

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

  • Напиши сервис Node.js на TypeScript со строгой типизацией и компози несколькими небольшими функциями.
  • Проверь tsconfig.json и предложи настройки для строгого режима TypeScript.
  • Разбери этот тип с помощью discriminated union и покажи безопасную обработку результата.

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

1Через Skills CLI (Vercel)

npx skills add julianobarbosa/claude-code-skills --skill writing-typescript -a claude-code

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

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

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

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

Вопросы о writing-typescript

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

Выполните npx skills add julianobarbosa/claude-code-skills --skill writing-typescript -a claude-code, затем проверьте файл ~/.claude/skills/writing-typescript/SKILL.md.

Что делает writing-typescript?

Скилл задаёт правила идиоматичной разработки на TypeScript: строгие проверки, работу с непроверенными данными, композицию функций и типовые паттерны. Он также подсказывает настройки tsconfig.json и команды для bun, vitest, eslint и prettier.

Какие TypeScript-настройки разбирает скилл?

Среди них strict: true, noUncheckedIndexedAccess, exactOptionalPropertyTypes, noImplicitReturns, isolatedModules, а также target: ES2022 и moduleResolution: bundler.

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

SKILL.md · MIT
---
name: writing-typescript
description: Idiomatic TypeScript development. Use when writing TypeScript code, Node.js services, React apps, or discussing TS patterns. Emphasizes strict typing, composition, and modern tooling (bun/vite).
allowed-tools: Read, Bash, Grep, Glob
---

# TypeScript Development (2025)

## Core Principles

- **Strict typing**: Enable all strict checks
- **Parse, don't validate**: Transform untrusted data at boundaries
- **Composition over inheritance**: Small, focused functions
- **Explicit over implicit**: No `any`, prefer `unknown`

## Toolchain

```bash
bun          # Runtime + package manager (fast)
vite         # Frontend bundling
vitest       # Testing
eslint       # Linting
prettier     # Formatting
```

## Quick Patterns

### Type Guards

```typescript
function isUser(value: unknown): value is User {
  return typeof value === "object" && value !== null && "id" in value;
}
```

### Discriminated Unions

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

function processResult<T>(result: Result<T>): T {
  if (result.ok) return result.value;
  throw result.error;
}
```

### Utility Types

```typescript
type UserUpdate = Partial<User>;
type UserSummary = Pick<User, "id" | "name">;
type UserWithoutPassword = Omit<User, "password">;
type ReadonlyUser = Readonly<User>;
```

## tsconfig.json Essentials

```json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "exactOptionalPropertyTypes": true,
    "noImplicitReturns": true,
    "isolatedModules": true
  }
}
```

## References

- [PATTERNS.md](PATTERNS.md) - Code patterns and style
- [REACT.md](REACT.md) - React component patterns
- [TESTING.md](TESTING.md) - Testing with vitest

## Commands

```bash
bun install              # Install deps
bun run build            # Build
bun test                 # Test
bun run lint             # Lint
bun run format           # Format
```

---

## Gotchas

- **`import type` with `verbatimModuleSyntax` and named exports**: type-only import of a value triggers errors. Fix: `import { type Foo } from "mod"` (inline marker).
- **`as const` on object: readonly AND literal-narrowed** — different from `as Foo` (asserts type) or `satisfies Foo` (validates without widening).
- **`satisfies` validates without widening; `as` widens** — using `as` where you wanted `satisfies` loses literal types silently.
- **`Array<T>.includes(x)` requires `x` to be of type `T`** — narrowing-from-union doesn't work; the standard fix is a type-predicate helper.
- **`strictNullChecks: false` makes `T` mean `T | null | undefined` for ALL types** — partial migrations leave types that lie about nullability.
- **`tsconfig.json` `extends` doesn't recursively merge `compilerOptions.paths`** — child paths REPLACE parent paths, not merge.

© julianobarbosa · MIT · julianobarbosa/claude-code-skills

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

Все скиллы по теме «Языки программирования» →
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-scaffold Seth Hobson Команда typescript-scaffold создаёт структуру TypeScript-проекта на pnpm: Next.js, React с Vite, Node.js API или библиотеку, вместе с тестами и сборкой. CX Codex +1 ★ 42 780звёзд репо typescript-expert PCL Team Скилл typescript-expert для экспертной разработки на TypeScript 5.0+ со строгой типизацией, современными инструментами сборки и тестирования. CX Codex +1 187установок javascript-typescript Seth Hobson Плагин javascript-typescript для Claude Code охватывает JavaScript и TypeScript с ES6+, Node.js, React и современными веб-фреймворками. Помогает агенту работать с таким проектом. CX Codex ★ 42 780звёзд репо typescript-node-stinger Legion Code Inc. Скилл typescript-node-stinger проверяет TypeScript и Node-код, включая настройки SvelteKit, типы, тесты и сборку npm-пакетов. Подходит для ревью и точечных правок. CX Codex +1 ★ 96звёзд репо typescript-node-wasp-drone Legion Code Inc. Субагент typescript-node-wasp-drone разбирает TypeScript и Node.js-код в приложениях SvelteKit на Vercel и npm-библиотеках или CLI. Помогает с типами, настройкой проверок и тестами. CX Codex ★ 96звёзд репо

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

Весь набор →
managing-infra Скилл managing-infra помогает выбрать между Helm и Kustomize, настроить модули Terraform и применить базовые стандарты безопасности в Kubernetes. CX Codex +1 115установок iterm2 Настраивает iTerm2 и tmux, управляет панелями и сессиями и разбирает неполадки. Помогает работать с терминалом на macOS. CX Codex +1 115установок context7 Скилл ищет документацию и примеры кода для конкретной версии библиотеки через Context7. Пригодится перед написанием кода по API, в котором вы не уверены. CX Codex +1 114установок git-worktree Управляет параллельными рабочими деревьями git worktree с созданием окон tmux и вкладок iTerm2. Помогает работать над ветками без stash. CX Codex +1 111установок az-aks-agent Скилл az-aks-agent для Claude Code разбирает состояние и настройки кластера Azure Kubernetes Service по запросам на обычном языке. Ищет проблемы с подами, сетью, хранилищем и RBAC. CX Codex +1 110установок writing-go Скилл writing-go задаёт агенту правила написания Go: стандартная библиотека вместо зависимостей, конкретные типы, ошибки с контекстом, табличные тесты. CX Codex +1 110установок macos-cleaner Скилл macos-cleaner анализирует, чем занято место на Mac, и предлагает варианты очистки. Он пригодится, когда нужно найти крупные файлы и оценить последствия удаления. CX Codex +1 109установок knative Скилл knative помогает развёртывать serverless-сервисы в Kubernetes, настраивать автомасштабирование до нуля и маршрутизировать события CloudEvents. CX Codex +1 109установок

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

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