antfu

SKILL.md

Opinionated TypeScript/JavaScript conventions and tooling setup for modern projects.

Covers code organization (single responsibility, type separation, constants extraction), runtime practices (isomorphic code with environment markers), and explicit TypeScript typing

Includes ESLint configuration via @antfu/eslint-config, Vitest testing patterns, and Git hooks with lint-staged for automated code formatting

Provides @antfu/ni command shortcuts for dependency management across package managers, and pnpm catalog-based version management for monorepos

References detailed guides for ESLint setup, project initialization, Vue/Nuxt app development, library publishing, and monorepo patterns

Coding Practices

Code Organization

Single responsibility: Each source file should have a clear, focused scope/purpose

Split large files: Break files when they become large or handle too many concerns

Type separation: Always separate types and interfaces into types.ts or types/*.ts

Constants extraction: Move constants to a dedicated constants.ts file

Runtime Environment

Prefer isomorphic code: Write runtime-agnostic code that works in Node, browser, and workers whenever possible

Clear runtime indicators: When code is environment-specific, add a comment at the top of the file:

// @env node
// @env browser