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

gravitas-typescript — скилл для Claude Code: что даёт и как ставить

Скилл gravitas-typescript для Claude Code настраивает строгую проверку типов, цепочку тестов в Vitest или Jest и запрещает небезопасные касты через as.

MIT 439 установок ★ 509 обновлён 2026-10-24

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

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

Скилл задаёт правила для TypeScript-проектов поверх основного набора GRAVITAS. Сначала он проводит разведку окружения: с помощью jq инспектирует tsconfig.json на флаги strict, noUncheckedIndexedAccess и exactOptionalPropertyTypes, проверяет версии в package.json и находит пути к алиасам. Это защищает от скрытых ошибок ещё до правки кода.

Для проверки сборки введена строгая цепочка команд: сначала tsc --noEmit, затем проверка линтером eslint . --max-warnings 0, а в конце запуск тестов через vitest или jest. Порядок фиксирован, потому что падение компилятора делает проверку тестами бесполезной. Также скилл запрещает использование any и подавление ошибок через оператор as. Вместо них агент обязан писать защитные проверки типов и размеченные объединения.

Этот модуль работает строго как надстройка над файлом skills/gravitas/SKILL.md — без предварительной загрузки основы контекста для работы не хватит.

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

  • Проверить настройки строгости в tsconfig.json перед рефакторингом
  • Найти скрытые any и небезопасные касты типов через as
  • Выстроить порядок верификации кода через tsc, eslint и vitest
  • Добавить типобезопасные проверки вместо явного приведения типов

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

  • Проверь tsconfig.json и найди нестрогие флаги компилятора в проекте
  • Запусти цепочку верификации для TypeScript и исправь ошибки типов
  • Перепиши небезопасные приведения as в модуле авторизации на тайп-гарды

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

1Через Skills CLI (Vercel)

npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a claude-code

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

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

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

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

Вопросы о gravitas-typescript

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

Выполните команду npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a claude-code. Конфигурация запишется в ~/.claude/skills/gravitas-typescript/SKILL.md.

Что нужно для работы gravitas-typescript?

Скилл работает как надстройка, поэтому сначала требуется загрузить базовый скилл из skills/gravitas/SKILL.md. В репозитории также должны быть установлены TypeScript, ESLint и тестовый фреймворк Vitest либо Jest.

В какой последовательности скилл проверяет код?

Команды выполняются строго по очереди: сначала tsc --noEmit для поиска ошибок компиляции, затем eslint . --max-warnings 0, и только после этого прогон тестов через vitest run --reporter=verbose или jest --verbose.

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

SKILL.md · MIT
---
name: gravitas-typescript
description: >
  GRAVITAS extension for TypeScript projects. Adds TypeScript-specific recon,
  strict mode patterns, Vitest/Jest integration, and common TS failure modes.
  Load in addition to the base GRAVITAS skill.
triggers:
  - "typescript"
  - "ts"
  - "tsx"
  - "react"
  - "next"
  - "vitest"
  - "jest"
---

# GRAVITAS — TypeScript Extension

Extends the base GRAVITAS skill with TypeScript-specific patterns.
Load `skills/gravitas/SKILL.md` first, then this file.

---

## TypeScript Recon Additions

Add to standard recon checklist:

```
□ tsconfig.json — strict mode? noUncheckedIndexedAccess? exactOptionalPropertyTypes?
□ package.json — TypeScript version, test runner (vitest vs jest)
□ eslint config — @typescript-eslint rules in effect
□ type declarations — are there .d.ts files that affect this module?
□ path aliases — does tsconfig have paths? (affects imports)
```

### Read tsconfig strictly

```bash
cat tsconfig.json | jq '.compilerOptions | {strict, noUncheckedIndexedAccess, exactOptionalPropertyTypes, target, lib}'
```

---

## TypeScript Verification Chain

```bash
# Full chain — always in this order
tsc --noEmit                           # catches type errors first
eslint . --max-warnings 0              # @typescript-eslint rules
vitest run --reporter=verbose          # or: jest --verbose

# With coverage
vitest run --coverage --reporter=verbose

# Type coverage (optional, requires type-coverage)
npx type-coverage --strict
```

---

## TypeScript-Specific Anti-Patterns

### Never use `any`
```typescript
BAD:  function process(data: any) { ... }
GOOD: function process(data: ProcessInput) { ... }
```

### Never use `as` to silence type errors
```typescript
BAD:  const user = data as User;  // silences real type error
GOOD: if (isUser(data)) { const user = data; ... }
```

### Handle `undefined` explicitly
```typescript
BAD:  const name = user.name;          // may be undefined
GOOD: const name = user.name ?? 'Anonymous';
```

### Strict null checks
```typescript
BAD:  return users.find(u => u.id === id).name;  // crash if not found
GOOD: return users.find(u => u.id === id)?.name;
```

---

## Common TypeScript Failure Modes

| Failure | Root Cause | Fix |
|---------|-----------|-----|
| `Object is possibly undefined` | Optional property accessed without guard | Add `?.` or null check |
| `Type 'string' is not assignable to 'number'` | Wrong type passed | Check function signature, fix caller |
| `Property does not exist on type` | Interface mismatch | Update interface or use correct property |
| `Cannot find module` | Path alias not in tsconfig | Add to `paths` in tsconfig |
| `Argument of type X is not assignable to Y` | Generic type mismatch | Check generic constraints |
| Implicit `any` in strict mode | Missing type annotation | Add explicit type |

---

## TypeScript Patterns

### Parameterized types over `any`
```typescript
function first<T>(arr: T[]): T | undefined {
  return arr[0];
}
```

### Discriminated unions for type safety
```typescript
type Result<T> =
  | { ok: true; data: T }
  | { ok: false; error: string };
```

### Type guards instead of casts
```typescript
function isUser(obj: unknown): obj is User {
  return typeof obj === 'object' && obj !== null && 'id' in obj;
}
```

---

## Test Patterns (Vitest)

### Test file location
Follow project convention — check existing tests:
```bash
find src/ -name "*.test.ts" | head -5  # see the pattern
```

### Standard test structure
```typescript
import { describe, it, expect, vi, beforeEach } from 'vitest';

describe('[module]', () => {
  beforeEach(() => { vi.clearAllMocks(); });

  it('[behavior] when [condition]', () => {
    // Arrange
    const input = ...;
    // Act
    const result = fn(input);
    // Assert
    expect(result).toEqual(expected);
  });
});
```

### Mocking
```typescript
vi.mock('../db', () => ({
  query: vi.fn().mockResolvedValue({ rows: [] })
}));
```

---

## Quick Reference

```bash
# Find all TypeScript errors
tsc --noEmit 2>&1 | grep "error TS"

# Find implicit any
tsc --noEmit --strict 2>&1

# Count test files
find src/ -name "*.test.ts" | wc -l

# Run single test file
vitest run src/auth/session.test.ts

# Watch mode (dev)
vitest --watch
```

© udaysharmadev · MIT · udaysharmadev/Gravitas

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

Все скиллы по теме «Языки программирования» →
typescript alinaqi Скилл для работы с TypeScript-файлами на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Включает strict mode, автоматическую проверку типов через eslint и jest, pre-commit хуки, чтобы ловить ошибки на месте. CX Codex +1 320установок typescript-expert martinholovsky Скилл typescript-expert задаёт агенту роль TypeScript-разработчика: строгая типизация, продвинутые типы и тесты раньше кода. CX Codex +1 285установок typescript-pro https://github.com/Jeffallan Скилл typescript-pro настраивает строгую типизацию TypeScript, генерирует брендированные типы и связывает tRPC. Пригодится при проектировании надёжных API и сложных generic-структур. CX Codex +1 14 900установок typescript-strict-migrator patricio0312rev Скилл typescript-strict-migrator для Claude Code переводит TypeScript-проект на strict по одному флагу после аудита ошибок. Миграция начинается с noImplicitAny, затем включает strictNullChecks и остальные флаги. CX Codex +1 280установок migrate-js-to-modern-typescript pproenca Скилл migrate-js-to-modern-typescript пошагово переводит проект с JavaScript на строгий TypeScript, настраивает tsconfig и помогает отказаться от any без поломки сборки. CX Codex +1 145установок typescript-discriminated-unions mkosir Скилл typescript-discriminated-unions учит ИИ-агента применять дискриминированные объединения в TypeScript для взаимоисключающих состояний и проверять исчерпывающий switch через ESLint. CX Codex +1 4 200установок

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

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

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