# Typescript Best Practices

> Applies idiomatic TypeScript patterns for naming, modules, async code, and maintainability. Use when writing or refactoring TypeScript/TSX, organizing imports, defining classes or functions, or working with async/await and modules.

- **Type:** Skill
- **Install:** `agentstack add skill-cuonglph11-mini-chris-typescript-best-practices`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cuonglph11](https://agentstack.voostack.com/s/cuonglph11)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cuonglph11](https://github.com/cuonglph11)
- **Source:** https://github.com/cuonglph11/mini-chris/tree/main/workspace/skills/typescript-best-practices

## Install

```sh
agentstack add skill-cuonglph11-mini-chris-typescript-best-practices
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TypeScript Best Practices

## Priority: P1 (Operational)

## Implementation Guidelines

- **Naming**: Classes and types = `PascalCase`; variables and functions = `camelCase`; constants = `UPPER_SNAKE`. Use `I` prefix for interfaces only when it adds clarity.
- **Functions**: Arrow functions for callbacks; regular functions for top-level exports. Always type public API return types.
- **Modules**: Prefer named exports. Import order: external → internal → relative.
- **Async**: Use `async/await`; use `Promise.all()` for parallel work instead of raw Promises where appropriate.
- **Classes**: Use explicit access modifiers; prefer composition; use `readonly` where appropriate.
- **Types**: Use `never` for exhaustiveness; use assertion functions (`asserts`) for runtime checks.
- **Optional**: Use `?:` for optional properties, not `| undefined` when the intent is “may be absent.”
- **Imports**: Use `import type` for type-only imports to improve tree-shaking.

## Anti-Patterns

- **No default exports**: Use named exports.
- **No implicit return types on public API**: Specify return types.
- **No unused variables**: Enable `noUnusedLocals` (and `noUnusedParameters` where applicable).
- **No `require`**: Use ES module `import`.
- **No empty interfaces**: Use a `type` alias or add at least one member.
- **No `any`**: Use strict types or `unknown` with explicit narrowing/casting.
- **Mocking in tests**: Use `jest.Mocked` and cast with `value as unknown as T`; avoid `any`.
- **No lint disables**: Do not use `eslint-disable` or `ts-ignore`; fix the underlying issue.

## Additional Resources

- [reference.md](reference.md) — Project structure, TSConfig, barrel exports.
- [examples.md](examples.md) — Immutable interfaces, exhaustiveness, assertion functions, DI, import order.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cuonglph11](https://github.com/cuonglph11)
- **Source:** [cuonglph11/mini-chris](https://github.com/cuonglph11/mini-chris)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cuonglph11-mini-chris-typescript-best-practices
- Seller: https://agentstack.voostack.com/s/cuonglph11
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.