Skip to main content
skill CX Codex

typescript · siviter-xyz — Claude Code skill: TypeScript standards

typescript is a Claude Code skill that sets standards for writing and changing TypeScript. It activates for TypeScript and TypeScript React files.

MIT 239 installs ★ 22 updated 2026-03-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add siviter-xyz/dot-agent --skill typescript -a claude-code
Open on GitHub

What typescript does

typescript provides guidelines for typing, module boundaries, and code style. It favors strict TypeScript, explicit annotations, and unknown over any when a value’s type is unclear. Public APIs and complex logic call for JSDoc comments; imports should point directly to modules rather than pass through barrel exports.

The skill covers test layout, type checks, Prettier formatting, and ESLint linting. It recommends Vitest for unit and integration tests, and Playwright for end-to-end tests. Vite and pnpm also appear in its tooling guidance. The suggested project commands include pnpm format and pnpm lint.

What it helps with

  • replace avoidable any with safer types
  • set clear boundaries between modules
  • add tests alongside TypeScript changes
  • apply formatting and lint checks

Example prompts for the agent

  • Review this TypeScript code against the skill’s rules and replace avoidable any types.
  • Inspect src/ and suggest tests for the changed modules.
  • Write a Vitest unit test for this function.

How to install typescript

1Skills CLI (Vercel)

npx skills add siviter-xyz/dot-agent --skill typescript -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/typescript/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about typescript

How do I install typescript in Claude Code?

Run npx skills add siviter-xyz/dot-agent --skill typescript -a claude-code. The skill file is available at ~/.claude/skills/typescript/SKILL.md.

What does the typescript skill do?

It gives TypeScript guidance on typing, module structure, tests, formatting, and linting.

Which testing tools does typescript recommend?

It recommends Vitest for unit and integration tests, and Playwright for end-to-end tests.

Source text

SKILL.md · MIT
---
name: typescript
description: TypeScript standards and best practices with modern tooling. Use when working with TypeScript or TypeScript React files.
---

# TypeScript Guidelines

Standards and best practices for TypeScript development with modern tooling. Follow these guidelines when writing or modifying TypeScript code.

## Design Principles

Apply DRY, KISS, and SOLID consistently. Prefer functional approaches where relevant; use classes for stateful behavior. Use composition over inheritance. Each module should have a single responsibility. Use dependency injection for class dependencies.

## Code Style

- **Naming**: Descriptive yet concise names for variables, functions, and classes
- **Documentation**: JSDoc comments for public APIs, complex logic, and non-obvious design decisions
- **Type annotations**: Be explicit with typing to reduce inference time; avoid `any` unless necessary
- **Imports**: Avoid barrel exports to prevent circular dependencies; prefer direct imports

## Type Safety

- **Strict TypeScript**: Use strict mode with proper type definitions. Use type-safe patterns like Zod schemas for validation and type-safe DOM helpers where applicable.
- **Avoid `any`**: Use `unknown` instead of `any` when the type is truly unknown. Narrow types appropriately.
- **Type inference**: Be explicit with typing to reduce inference time and improve clarity

## Type Patterns

- **Union types**: Use union types for values that can be one of several types
- **Discriminated unions**: Use discriminated unions for type-safe state machines
- **Generic constraints**: Use generic constraints to ensure type safety
- **Utility types**: Leverage TypeScript utility types (Pick, Omit, Partial, etc.)

## Architecture

### Module Organization

- Each module focuses on one concern with clear boundaries
- Extract reusable functions to avoid duplication
- Design for reusability across contexts
- Co-locate types with their usage or in dedicated type files
- Keep types at appropriate module boundaries

### Dependency Management

- Use dependency injection for testability
- Prefer composition over inheritance
- Keep dependencies minimal and focused

## Testing

### Structure

- Tests mirror `src/` directory structure
- Test files: `*.test.ts` or `*.spec.ts`
- Use descriptive test names
- Always check for appropriate unit tests when changing code

### Quality

- Use AAA (Arrange, Act, Assert) pattern
- Tests should be useful, readable, concise, maintainable
- Test edge cases and error conditions
- Maintain test coverage for critical paths

### Tools

- **Vitest**: Use Vitest for unit and integration tests (preferred over Jest)
- Use `@vitest/coverage-v8` for coverage
- Use `jsdom` for DOM testing when needed
- Mock external dependencies appropriately
- **Playwright**: Use Playwright for end-to-end (E2E) tests

## Code Formatting and Linting

### Prettier

- Use Prettier for consistent code formatting
- Config: `printWidth: 120`, `singleQuote: true`, `jsxSingleQuote: true`
- Run `pnpm format` to format code
- Run `pnpm format:check` to check formatting

### ESLint

- Use ESLint with TypeScript plugin
- Use `@typescript-eslint/parser` and `@typescript-eslint/eslint-plugin`
- Run `pnpm lint` to check linting
- Run `pnpm lint:fix` to auto-fix issues

## Framework Recommendations

### For Non-Heavy Client Interaction

- **Astro**: Excellent choice for content-focused sites, blogs, documentation
  - Minimal JavaScript by default
  - Static generation with server islands when needed
  - Great performance and SEO
  - TypeScript-first with excellent DX

### For Heavy Client Interaction

- React, Svelte, or SolidJS with TypeScript
- Choose based on team preference and project requirements

## Build Tools

- **Vite**: Preferred build tool for development and production (unless directed otherwise)
- **Modern Rust-based tooling**: Prefer Rolldown or other lower-level language tooling
  - Avoid Webpack and other older JavaScript-based bundlers unless specifically required

## Package Management

- **pnpm**: Preferred package manager (faster, more efficient than npm/yarn)
- Use `packageManager` field in package.json
- Use pnpm workspaces for monorepos

## Implementation

When implementing TypeScript code:
- Ensure code passes type checking before committing
- Group related changes with tests in atomic commits
- Check for existing workflow patterns (spec-first, TDD, etc.) and follow them

## References

For monorepo-specific patterns using pnpm, see `references/pnpm-monorepo.md`.

© siviter-xyz · MIT · siviter-xyz/dot-agent

Similar skills

All skills for Programming languages →

typescript by other authors comes first.

typescript gentleman-programming Enforces strict TypeScript rules: const types, flat interfaces, type guards. Kicks in when the agent writes types, interfaces, or generics. CX Codex +1 500installs typescript PyModel This skill for Claude Code provides guidance on TypeScript 7 types and configuration. Ask the agent to apply it while editing tsconfig.json, async code, or module imports. CX Codex +1 657installs typescript alinaqi Skill for TypeScript work across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Configures strict mode, type checking via eslint and jest, pre-commit hooks to catch errors early. CX Codex +1 320installs typescript Mindrally Enforces strict TypeScript standards and functional code patterns in your AI assistant. It bans any, replaces enums with maps, and caps function length at 20 lines. CX Codex +1 1,000installs typescript sentimony typescript guides coding agents through compiler errors, strict flags, and tsconfig setups across monorepos and web frameworks. Useful for tricky typing issues. CX Codex +1 5,200installs gravitas-typescript udaysharmadev gravitas-typescript is a Claude Code skill that enforces strict TypeScript checks, sets up tests with Vitest or Jest, and blocks unsafe as casts. CX Codex +1 439installs antfu Anthony Fu antfu hands your agent Anthony Fu's rules for JavaScript and TypeScript work: file layout, ESLint, Knip, package publishing. Useful when starting a project or wiring a monorepo. CX Codex +1 17,400installs TypeScript Library taste f TypeScript Library taste is a ChatGPT prompt for setting build and release conventions for TypeScript libraries. It covers tests, package exports, and versioning. GP ChatGPT ★ 178,201repo stars typescript-scaffold Seth Hobson typescript-scaffold generates a TypeScript project skeleton on pnpm: Next.js, React with Vite, Node.js API or a library, with tests and build tooling. CX Codex +1 ★ 42,780repo stars typescript-node-stinger Legion Code Inc. The typescript-node-stinger skill reviews TypeScript and Node code, including SvelteKit typing, project settings, tests, and npm package builds. Use it for focused code checks. CX Codex +1 ★ 96repo stars typescript-node-wasp-drone Legion Code Inc. typescript-node-wasp-drone reviews TypeScript and Node.js projects built as SvelteKit apps on Vercel or npm libraries and CLIs. Use it for typing, validation, tests, and project tooling. CX Codex ★ 96repo stars

From the same set11

The whole set →
cursor-best-practices cursor-best-practices — a Cursor skill covering planning, context handling, TDD, and parallel agents. Pull it in when you start a codebase task and want a known workflow instead of improvising. CX Codex +1 640installs software-engineer software-engineer — a skill that gives the agent rules for code style, documentation and workflow: no filler comments, no git commits on its own, questions when something is unclear. CX Codex +1 637installs python Gives the agent one set of Python conventions: typing, dependency injection, module and test layout. Useful when edits land in an existing codebase. CX Codex +1 353installs create-agents-md create-agents-md generates repo-committed AGENTS.md files for inline rules. Useful for keeping code style, build commands, and safety boundaries close to the code. CX Codex +1 306installs cli-building cli-building guides AI agents to build command-line tools using async-first patterns, modular command composition, and terminal formatting with NO_COLOR support. CX Codex +1 201installs semantic-git The semantic-git skill groups related changes into atomic commits and formats messages as Conventional Commits. Use it when an agent is preparing Git changes for commit. CX Codex +1 201installs debugging debugging is a Claude Code skill that guides root cause analysis for errors and test failures. It helps localize bugs and prepare minimal, verified fixes. CX Codex +1 151installs media-processing media-processing is a Claude Code skill for batch media workflows: resizing images, converting audio, and compressing video with FFmpeg, ImageMagick, and Python scripts. CX Codex +1 151installs

Project sponsors

Companies that keep this analytics open