antfu

Original：🇺🇸 English

Translated

Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects. Use when setting up new projects, configuring ESLint/Prettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.

5.9kinstalls

Sourceantfu/skills

Added on2026-02-04

NPX Install

npx skill4agent add antfu/skills antfu

SKILL.md Content

View Translation Comparison →

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:

ts

// @env node
// @env browser

TypeScript

Explicit return types: Declare return types explicitly when possible
Avoid complex inline types: Extract complex types into dedicated
```
type
```
or
```
interface
```
declarations

Comments

Avoid unnecessary comments: Code should be self-explanatory
Explain "why" not "how": Comments should describe the reasoning or intent, not what the code does

Testing (Vitest)

Test files:
```
foo.ts
```
→
```
foo.test.ts
```
(same directory)
Use
```
describe
```
/
```
it
```
API (not
```
test
```
)
Use
```
toMatchSnapshot
```
for complex outputs
Use
```
toMatchFileSnapshot
```
with explicit path for language-specific snapshots

Tooling Choices

@antfu/ni Commands

Command	Description
`ni`	Install dependencies
`ni <pkg>` / `ni -D <pkg>`	Add dependency / dev dependency
`nr <script>`	Run script
`nu`	Upgrade dependencies
`nun <pkg>`	Uninstall dependency
`nci`	Clean install ( `pnpm i --frozen-lockfile` )
`nlx <pkg>`	Execute package ( `npx` )

TypeScript Config

json

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true
  }
}

ESLint Setup

js

// eslint.config.mjs
import antfu from '@antfu/eslint-config'

export default antfu()

When completing tasks, run

pnpm run lint --fix

to format the code and fix coding style.

For detailed configuration options: antfu-eslint-config

Git Hooks