typescript-expert · personamanagmentlayer — скилл для Claude Code: что делает и как установить
Скилл typescript-expert для экспертной разработки на TypeScript 5.0+ со строгой типизацией, современными инструментами сборки и тестирования.
Apache-2.0 187 установок ★ 45 обновлён 2026-10-12
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/typescript-expert/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/typescript-expert/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a codex2Вручную: положить файлы
.agents/skills/typescript-expert/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a cursor2Вручную: положить файлы
.cursor/skills/typescript-expert/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install personamanagmentlayer/pcl stdlib/languages/typescript-expert2Вручную: положить файлы
.github/skills/typescript-expert/SKILL.md1Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a gemini-cli2Командой платформы
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/languages/typescript-expertВручную: положить файлы
.devin/skills/typescript-expert/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add personamanagmentlayer/pcl --skill typescript-expert -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.