gravitas-typescript — скилл для Claude Code: что даёт и как ставить
Скилл gravitas-typescript для Claude Code настраивает строгую проверку типов, цепочку тестов в Vitest или Jest и запрещает небезопасные касты через as.
MIT 439 установок ★ 509 обновлён 2026-10-24
npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/gravitas-typescript/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gravitas-typescript/
1Через Skills CLI (Vercel)
npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a codex2Вручную: положить файлы
.agents/skills/gravitas-typescript/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a cursor2Вручную: положить файлы
.cursor/skills/gravitas-typescript/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install udaysharmadev/Gravitas skills/gravitas-typescript2Вручную: положить файлы
.github/skills/gravitas-typescript/SKILL.md1Через Skills CLI (Vercel)
npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a gemini-cli2Командой платформы
gemini skills install https://github.com/udaysharmadev/Gravitas --path skills/gravitas-typescriptВручную: положить файлы
.devin/skills/gravitas-typescript/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add udaysharmadev/Gravitas --skill gravitas-typescript -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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