# Build Better TypeScript Node.js Tools

TypeScript and Node.js projects need consistent standards for strict typing, performance, errors, and tests. This skill gives practical patterns for CLI tools, libraries, reviews, and refactors.

## Install

```bash
npx skillstore add dammianmiller/typescript-node-expert
```

## Metadata

- Status: approved
- Slug: dammianmiller-typescript-node-expert
- Skillstore revision: r1
- Version status: missing
- Tree hash: 1422c347885db7de10435950ba7f628503539c1c5fb62f224213c300db14329d
- Author: DammianMiller
- GitHub username: DammianMiller
- License: MIT
- Repository: https://github.com/DammianMiller/universal-agent-memory/tree/main/.factory/skills/typescript-node-expert
- Ref: 26421118b848d9f1efc0aa169d8a7a9e7e0a877e
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/dammianmiller-typescript-node-expert
- Manifest: https://skillstore.pages.dev/api/skills/dammianmiller-typescript-node-expert/manifest

## Capabilities

- Defines strict TypeScript compiler settings for Node.js projects.
- Shows safer typing with unknown, type guards, and explicit returns.
- Explains async, streaming, and generator patterns for better performance.
- Provides CLI structure guidance using Commander.js options and subcommands.
- Recommends error handling with custom errors and Result types.
- Includes Vitest testing patterns and review checklist items.

## Use Cases

- Create a CLI Tool: Plan a typed Node.js CLI with Commander.js commands, options, errors, and tests.
- Review a TypeScript Module: Check strict typing, async flow, error handling, test coverage, and maintainable module boundaries.
- Refactor for Performance: Replace memory-heavy patterns with parallel async work, streams, and lazy collection processing.

## Prompt Templates

### Review Strict Typing

```
Review this TypeScript file for strict typing, explicit return types, null safety, and simple fixes. Explain each issue before changing it.
```

### Design a CLI Command

```
Design a Node.js CLI command for this feature. Include command shape, option names, validation rules, error behavior, and test cases.
```

### Improve Runtime Performance

```
Refactor this module for performance. Look for sequential awaits, large in-memory reads, avoidable allocations, and streaming opportunities.
```

### Audit Library Architecture

```
Audit this library architecture. Evaluate module boundaries, dependency injection, exported types, error taxonomy, test strategy, and release readiness.
```

## Limitations

- It is guidance only and does not include executable helper scripts.
- Examples need adaptation to each project architecture and dependency set.
- It does not replace project-specific security review or threat modeling.
- It focuses on TypeScript and Node.js, not browser frameworks or other runtimes.

## Best Practices

- Run the skill before TypeScript feature work, refactors, bug fixes, and reviews.
- Share relevant tsconfig, package scripts, and test conventions with the agent.
- Ask for focused changes when you need minimal churn in an existing codebase.

## Anti Patterns

- Using broad prompts that ask for all improvements at once.
- Accepting examples without adapting names, dependencies, and project conventions.
- Skipping tests after changes that affect CLI behavior, IO, or error handling.

## Security Audit

- Audited at: 2026-07-09T14:52:51.761\+00:00
- Summary: All static findings are false positives caused by Markdown code fences, inline code formatting, and illustrative TypeScript examples. The skill contains coding guidance only, with no prompt injection, data exfiltration intent, or executable helper scripts found in SKILL.md.

## Stats

- Views: 245
- Downloads: 10
- Favorites: 0
- Popularity score: 0