rulebook-typescript

hivellm's avatarfrom hivellm

TypeScript development with strict mode, Vitest testing, ESLint linting, and CI/CD best practices. Use when working on TypeScript projects, writing tests, configuring linting, or setting up build pipelines.

⭐5stars🔀0forks📁View on GitHub🕐Updated Dec 10, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive framework for high-quality TypeScript development, integrating strict type-checking, Vitest testing, and ESLint linting. It solves the problem of inconsistent code quality and fragile builds by enforcing industry-standard best practices and automated quality gates throughout the development lifecycle.

Use Cases

  • Standardizing TypeScript configurations across team projects to ensure consistent code quality and strict type enforcement.
  • Implementing automated testing suites using Vitest to achieve high code coverage (95%+) and reduce production regressions.
  • Configuring ESLint and Prettier rules to maintain clean, readable code and prevent common programming errors in complex TypeScript environments.
  • Setting up robust CI/CD pipelines with pre-defined quality check commands for type-checking, linting, and build verification.
namerulebook-typescript
descriptionTypeScript development with strict mode, Vitest testing, ESLint linting, and CI/CD best practices. Use when working on TypeScript projects, writing tests, configuring linting, or setting up build pipelines.
version"1.0.0"
categorylanguages
author"HiveLLM"
tags["typescript", "javascript", "node", "strict", "testing", "vitest", "eslint"]
dependencies[]
conflicts[]

TypeScript Development Standards

Quality Check Commands

Run these commands after every implementation:

npm run type-check        # TypeScript type checking
npm run lint              # ESLint (0 warnings required)
npm run format            # Prettier formatting
npm test                  # Run all tests
npm run test:coverage     # Coverage check (95%+ required)
npm run build             # Build verification

TypeScript Configuration

Use TypeScript 5.3+ with strict mode:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "node",
    "strict": true,
    "esModuleInterop": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitReturns": true
  }
}

Code Quality Rules

  1. No any type - Use unknown with type guards
  2. Strict null checks - Handle null/undefined explicitly
  3. Type guards over assertions - Avoid as keyword
  4. 95%+ test coverage - Required for all new code

Testing with Vitest

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

describe('myFunction', () => {
  it('should handle valid input', () => {
    expect(myFunction('input')).toBe('expected');
  });
});

ESLint Setup

{
  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
  "parser": "@typescript-eslint/parser",
  "rules": {
    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
    "@typescript-eslint/no-explicit-any": "warn"
  }
}