Agent skill

Typescript Best Practices

by Taoidle in Taoidle/plan-cascade

TypeScript/Node.js best practices. An agent skill from Taoidle/plan-cascade.

MITAuto-check passedDevelopment

Install Typescript Best Practices

skills CLI
$ npx skills add Taoidle/plan-cascade --skill typescript-best-practices -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Taoidle/plan-cascade typescript-best-practices --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Taoidle/plan-cascade.git skills-src && mkdir -p .claude/skills && cp -r skills-src/builtin-skills/typescript .claude/skills/typescript-best-practices && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
typescript-best-practices
GitHub stars
133
Token cost
~534 tokens
SKILL.md length
63 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

TypeScript/Node.js best practices. An agent skill from Taoidle/plan-cascade.

  • Reviewing TypeScript code
  • SKILL.md covers Code Style, Type Safety, Error Handling and Project Structure, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Type safety

What it does

Typescript Best Practices is an agent skill from Taoidle/plan-cascade. TypeScript/Node.js best practices. Use when writing or reviewing TypeScript code. Covers type safety, async patterns, and error handling.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Type safety, Error handling and Linting and formatting. It works with TypeScript and Node.js. The repository describes itself as: AI-powered cascading development framework. Decompose complex projects into parallel executable tasks with auto-generated PRDs, design docs, and multi-agent collaboration (Claude… The licence is MIT.

When your agent uses it

  • Reviewing TypeScript code
  • Tasks that involve Type safety
  • Tasks that involve Error handling

Example prompts

  • “/typescript-best-practices”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 5223f82. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Typescript Best Practices loads about 534 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 63 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~534

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Taoidle/plan-cascade at commit 5223f82, republished under its MIT licence (© Taoidle). 63 words, ~534 tokens.

Download SKILL.mdSave it as .claude/skills/typescript-best-practices/SKILL.md (or your agent's skills folder).
name
typescript-best-practices
description
TypeScript/Node.js best practices. Use when writing or reviewing TypeScript code. Covers type safety, async patterns, and error handling.
license
MIT
metadata.author
plan-cascade
metadata.version
1.0.0

TypeScript Best Practices

Code Style

RuleGuideline
FormatterPrettier
LinterESLint + @typescript-eslint
Strict modestrict: true in tsconfig

Type Safety

RuleGuideline
Avoid anyUse unknown + narrowing
Type guardsCustom predicates
Discriminated unionsFor variants
typescript
type Result<T> = { success: true; data: T } | { success: false; error: Error };

function isUser(v: unknown): v is User {
  return typeof v === 'object' && v !== null && 'id' in v;
}

Error Handling

typescript
class ApiError extends Error {
  constructor(message: string, public status: number) {
    super(message);
    this.name = 'ApiError';
  }
}

async function fetchUser(id: string): Promise<User> {
  const res = await fetch(`/api/users/${id}`);
  if (!res.ok) throw new ApiError('Failed', res.status);
  return res.json();
}

Project Structure

src/{index.ts, types/, services/, utils/}
tests/
package.json, tsconfig.json

Async Patterns

PatternUsage
Promise.allParallel operations
AbortControllerCancellation
typescript
const [user, settings] = await Promise.all([fetchUser(id), fetchSettings(id)]);

Anti-Patterns

AvoidUse Instead
as assertionsType guards
! non-null?. and ??
anyunknown + narrowing
typescript
// Bad: data as User, user!.name
// Good:
if (isUser(data)) { /* data is User */ }
const name = user?.name ?? 'Unknown';

Testing (Vitest)

typescript
describe('Service', () => {
  it('should create', async () => {
    const mock = { save: vi.fn().mockResolvedValue({ id: '1' }) };
    const result = await new Service(mock).create({ name: 'Test' });
    expect(result.id).toBe('1');
  });
});

© Taoidle, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in builtin-skills/typescript of Taoidle/plan-cascade.

Open the folder on GitHubat commit 5223f82

Compare with similar skills

Typescript Best Practices next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Typescript Best Practices compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Typescript Best Practices this skillTaoidle/plan-cascade133—~534Automated safety check: PassMIT
Add NodeBridge Handlerneovateai/neovate-code1.6k—~1kAutomated safety check: PassMIT
Obsidian Plugin Development Guidelinesgapmiss/obsidian-plugin-skill190—~4.5kAutomated safety check: PassMIT
Strict Programming Practicescode-yeongyu/oh-my-openagent70k—~9.5kAutomated safety check: PassCustom licence
Fallow Setupfallow-rs/fallow-skills129—~1.1kAutomated safety check: PassMIT
Ban Type AssertionsFactory-AI/factory-plugins110—~1.7kAutomated safety check: PassNone

Similar skills

  • Add NodeBridge Handler

    neovateai/neovate-code

    Walks through adding a message handler to NodeBridge in Neovate Code, from the implementation and its types to an optional test entry and a run with Bun.

    1.6k GitHub stars~1k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Obsidian Plugin Development Guidelines

    gapmiss/obsidian-plugin-skill

    Rules and references for building Obsidian plugins: ESLint rules, TypeScript practices, memory cleanup, API choices, UI standards and the community submission process.

    190 GitHub stars~4.5k tokensUpdated 12 days ago
    DevelopmentAuto-check passed
  • Strict Programming Practices

    code-yeongyu/oh-my-openagent

    Applies strict, type-first coding rules for Python, Rust, TypeScript and Go, loading the matching language reference before the agent writes or edits any code.

    70k GitHub stars~9.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Fallow Setup

    fallow-rs/fallow-skills

    Set up or modernize code-quality tooling for JavaScript and TypeScript projects.

    129 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Ban Type Assertions

    Factory-AI/factory-plugins

    Ban as type assertions in a package via the @typescript-eslint/consistent-type-assertions lint rule, replacing them with compiler-verified type-safe alternatives.

    110 GitHub stars~1.7k tokensUpdated 21 days ago
    DevelopmentAuto-check passed
  • Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies type safety and error handling rules. An agent skill from shinpr/ai-coding-project-boilerplate.

    232 GitHub stars~1.5k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from Taoidle/plan-cascade

  • Go Best Practices

    Taoidle/plan-cascade

    Go coding best practices. An agent skill from Taoidle/plan-cascade.

    133 GitHub stars~541 tokensUpdated 6 mo ago
    Auto-check passed
  • Hybrid Ralph

    Taoidle/plan-cascade

    Hybrid architecture combining Ralph's PRD format with Planning-with-Files' structured approach.

    133 GitHub stars~4.1k tokensUpdated 6 mo ago
    Auto-check: notes
  • Java Best Practices

    Taoidle/plan-cascade

    Java coding best practices. An agent skill from Taoidle/plan-cascade.

    133 GitHub stars~519 tokensUpdated 6 mo ago
    Auto-check passed
  • Mega Plan

    Taoidle/plan-cascade

    Project-level multi-task orchestration system. An agent skill from Taoidle/plan-cascade.

    133 GitHub stars~3.4k tokensUpdated 6 mo ago
    Auto-check: notes
  • Python Best Practices

    Taoidle/plan-cascade

    Python coding best practices. An agent skill from Taoidle/plan-cascade.

    133 GitHub stars~463 tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Typescript Best Practices

What does Typescript Best Practices do?

TypeScript/Node.js best practices. An agent skill from Taoidle/plan-cascade. Typescript Best Practices is an agent skill from Taoidle/plan-cascade.js best practices.

When should I use Typescript Best Practices?

Typescript Best Practices fits situations like: reviewing TypeScript code; tasks that involve Type safety; tasks that involve Error handling.

How do I install Typescript Best Practices in Claude Code?

Run `npx skills add Taoidle/plan-cascade --skill typescript-best-practices -a claude-code`. Or copy the skill folder (builtin-skills/typescript in Taoidle/plan-cascade) into .claude/skills/typescript-best-practices in your project. Claude Code loads it when a task matches its description.

How do I install Typescript Best Practices in Codex?

Run `npx skills add Taoidle/plan-cascade --skill typescript-best-practices -a codex`. Or copy the skill folder (builtin-skills/typescript in Taoidle/plan-cascade) into .agents/skills/typescript-best-practices in your project. Codex loads it when a task matches its description.

Can I use Typescript Best Practices in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Taoidle/plan-cascade --skill typescript-best-practices -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/typescript-best-practices, .gemini/skills/typescript-best-practices, .github/skills/typescript-best-practices and .opencode/skills/typescript-best-practices in your project.

What does Typescript Best Practices need to run?

SKILL.md names no scripts, command-line tools or credentials: Typescript Best Practices is instructions for the agent only. Our summary lists: Node.js.

Does Typescript Best Practices access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Typescript Best Practices safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Typescript Best Practices use?

Typescript Best Practices is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Typescript Best Practices use?

About 534 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Typescript Best Practices?

Skills that share tags, products or a category with Typescript Best Practices: Add NodeBridge Handler (neovateai/neovate-code, 1.6k stars), Obsidian Plugin Development Guidelines (gapmiss/obsidian-plugin-skill, 190 stars), Strict Programming Practices (code-yeongyu/oh-my-openagent, 70k stars) and Fallow Setup (fallow-rs/fallow-skills, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Typescript Best Practices?

Taoidle (a GitHub user) maintains it in Taoidle/plan-cascade, which has 133 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on March 14, 2026.

Source: Taoidle/plan-cascade on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.