Agent-Skills.md

Agent Skills: TypeScript Development Standards

TypeScript development standards for frontend and backend projects. Use when working with TypeScript, configuring path aliases, setting up test runners (Vitest/Jest), or organizing test files. Covers Vite alias configuration and type checking.

UncategorizedID: tianjianjiang/smith/smith-typescript

Repository

tianjianjiang/smith
tianjianjiang

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tianjianjiang/smith/tree/HEAD/smith-typescript

Skill Files

Browse the full folder contents for smith-typescript.

Download Skill

Loading file tree…

smith-typescript/SKILL.md

Skill Metadata

Name
smith-typescript
Description
TypeScript development standards for frontend and backend projects. Use when working with TypeScript, configuring path aliases, setting up test runners (Vitest/Jest), or organizing test files. Covers Vite alias configuration and type checking.

TypeScript Development Standards

<metadata>
  • Scope: TypeScript projects (frontend or backend)
  • Load if: Working with TypeScript
  • Prerequisites: @smith-principles/SKILL.md, @smith-standards/SKILL.md
</metadata>

CRITICAL: Path Aliases (Primacy Zone)

<required>

Configure path aliases in test config - Vite's ~ and @ aliases need explicit test runner setup.

</required>

Path Aliases in Test Config

<context>

Vite-based projects use ~ and @ as path aliases. Test runners need explicit configuration.

</context> <examples> 
// vitest.config.ts or jest.config.ts
resolve: {
  alias: {
    '~': projectRoot,
    '@': projectRoot,
  },
}
</examples>

Test File Organization

<required>
  • Place tests adjacent to source in __tests__/ directories
  • Use consistent extension (.spec.ts or .test.ts)
</required>

Type Checking

<context>

Framework CLIs may provide enhanced type checking. Match CI configuration for consistency.

</context>

Claude Code LSP (Experimental)

<context>

LSP plugins exist but are currently broken (race condition in initialization):

  • typescript-lsp@claude-plugins-official
  • pyright-lsp@claude-plugins-official

When fixed, LSP provides: goToDefinition, findReferences, hover, documentSymbol, getDiagnostics

Workaround: Use Serena MCP for language server features (find_symbol, find_referencing_symbols)

</context> <related>
  • @smith-tests/SKILL.md - Testing standards
  • @smith-dev/SKILL.md - Development workflow
  • @smith-serena/SKILL.md - Serena MCP for language server features
</related>

ACTION (Recency Zone)

<required>

Before running tests:

  1. Configure path aliases in vitest/jest config
  2. Match CI type-checking configuration
  3. Place tests in __tests__/ adjacent to source
</required>