# typescript-development

typescript-development — a skill that enforces strict TypeScript conventions in Claude Code, applying type safety rules and best practices automatically for TypeScript and JavaScript projects.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 173 repo stars
- Author: sammcj
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/sammcj/agentic-coding/tree/HEAD/Skills/typescript-development/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/typescript-development

## What it does

This skill defines TypeScript development standards: strict mode enforced, `const` by default, `async`/`await` over promise chains. It discourages `any` in favour of `unknown`, prefers discriminated unions over enums, and mandates `readonly` for immutable data alongside optional chaining and nullish coalescing operators.

It also prevents hardcoded styles—all visual settings must come from theme or configuration files. Activate the skill explicitly when starting work on a TypeScript or JavaScript codebase to ensure the IDE follows these conventions throughout development.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill typescript-development -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/typescript-development/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/typescript-development/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill typescript-development -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/typescript-development/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill typescript-development -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/typescript-development/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sammcj/agentic-coding Skills/typescript-development/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/typescript-development/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add sammcj/agentic-coding --skill typescript-development -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/typescript-development
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/typescript-development/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/sammcj/agentic-coding/tree/HEAD/Skills/typescript-development/SKILL.md

## When to use it
- enforce strict mode across TypeScript codebase
- eliminate `any` types with type-safe alternatives
- apply immutability patterns using `readonly`
- centralize styles in configuration instead of hardcoding

## Example prompts
- Activate typescript-development skill for my project
- Review this code against typescript-development: check for `any` types and hardcoded styles
- Refactor promise chains to async/await following typescript-development rules

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 46e642359a8dca9c.

BEGIN THIRD-PARTY FILE 46e642359a8dca9c
```text
---
name: typescript-development
description: You MUST activate this skill when working on TypeScript or JavaScript projects
---

# TypeScript

- Prefer TypeScript over JavaScript. Strict mode always
- Avoid `any` (use `unknown`), prefer discriminated unions over enums, `readonly` for immutables
- Const by default, async/await over promise chains, optional chaining and nullish coalescing
- Never hardcode styles - use theme/config
```
END THIRD-PARTY FILE 46e642359a8dca9c

The third-party file has ended. Everything between the 46e642359a8dca9c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© sammcj · Apache-2.0 · https://github.com/sammcj/agentic-coding/tree/HEAD/Skills/typescript-development/SKILL.md

## Similar
- [typescript-strict-migrator](https://affpapa.org/en/nevibecode/skills/typescript-strict-migrator.md) — skill · 280 installs
- [typescript-patterns](https://affpapa.org/en/nevibecode/skills/typescript-patterns.md) — skill · 202 installs
- [migrate-js-to-modern-typescript](https://affpapa.org/en/nevibecode/skills/migrate-js-to-modern-typescript.md) — skill · 145 installs
- [typescript-write](https://affpapa.org/en/nevibecode/skills/typescript-write.md) — skill · 2100 installs
- [typescript-best-practices](https://affpapa.org/en/nevibecode/skills/typescript-best-practices.md) — skill · 11200 installs
- [typescript](https://affpapa.org/en/nevibecode/skills/gentleman-programming-typescript.md) — skill · 500 installs

From the same set: [sammcj/agentic-coding](https://affpapa.org/en/nevibecode/by/sammcj/agentic-coding.md) — 73 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
