How do I install the Antfu skill?

Run npx skillmds@latest add alexanderop/antfu in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Antfu safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Antfu?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Antfu free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

alexanderop (@alexanderop) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Antfu by alexanderop — Agent Skill

Name: Antfu
Author: alexanderop

Antfu

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.

alexanderop 34f808f 6 files · 15.9 KB Updated Sep 17, 2026

File contents

Anthony Fu's Preferences

Category	Preference
Package Manager	pnpm (with `@antfu/ni` for unified commands)
Language	TypeScript (strict mode, ESM only)
Linting & Formatting	`@antfu/eslint-config` (no Prettier)
Testing	Vitest
Git Hooks	simple-git-hooks + lint-staged
Bundler (Libraries)	tsdown
Documentation	VitePress

Core Conventions

@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

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

ESLint Setup

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

export default antfu()

Fix linting errors with nr lint --fix. Do NOT add a separate lint:fix script.

For detailed configuration options: antfu-eslint-config

Git Hooks

{
  "simple-git-hooks": {
    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
  },
  "lint-staged": { "*": "eslint --fix" },
  "scripts": { "prepare": "npx simple-git-hooks" }
}

Vitest Conventions

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

pnpm Catalogs

Use named catalogs in pnpm-workspace.yaml for version management:

Catalog	Purpose
`prod`	Production dependencies
`inlined`	Bundler-inlined dependencies
`dev`	Dev tools (linter, bundler, testing)
`frontend`	Frontend libraries

Avoid the default catalog. Catalog names can be adjusted per project needs.

References

Topic	Description	Reference
ESLint Config	Framework support, formatters, rule overrides, VS Code settings	antfu-eslint-config
Project Setup	.gitignore, GitHub Actions, VS Code extensions	setting-up
App Development	Vue/Nuxt/UnoCSS conventions and patterns	app-development
Library Development	tsdown bundling, pure ESM publishing	library-development
Monorepo	pnpm workspaces, centralized alias, Turborepo	monorepo

---name: antfudescription: 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.---# Anthony Fu's Preferences| Category | Preference ||----------|------------|| Package Manager | pnpm (with `@antfu/ni` for unified commands) || Language | TypeScript (strict mode, ESM only) || Linting & Formatting | `@antfu/eslint-config` (no Prettier) || Testing | Vitest || Git Hooks | simple-git-hooks + lint-staged || Bundler (Libraries) | tsdown || Documentation | VitePress |---## Core Conventions### @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.mjsimport antfu from '@antfu/eslint-config'export default antfu()```Fix linting errors with `nr lint --fix`. Do NOT add a separate `lint:fix` script.For detailed configuration options: [antfu-eslint-config](references/antfu-eslint-config.md)### Git Hooks```json{ "simple-git-hooks": { "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged" }, "lint-staged": { "*": "eslint --fix" }, "scripts": { "prepare": "npx simple-git-hooks" }}```### Vitest Conventions- 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---## pnpm CatalogsUse named catalogs in `pnpm-workspace.yaml` for version management:| Catalog | Purpose ||---------|---------|| `prod` | Production dependencies || `inlined` | Bundler-inlined dependencies || `dev` | Dev tools (linter, bundler, testing) || `frontend` | Frontend libraries |Avoid the default catalog. Catalog names can be adjusted per project needs.---## References| Topic | Description | Reference ||-------|-------------|-----------|| ESLint Config | Framework support, formatters, rule overrides, VS Code settings | [antfu-eslint-config](references/antfu-eslint-config.md) || Project Setup | .gitignore, GitHub Actions, VS Code extensions | [setting-up](references/setting-up.md) || App Development | Vue/Nuxt/UnoCSS conventions and patterns | [app-development](references/app-development.md) || Library Development | tsdown bundling, pure ESM publishing | [library-development](references/library-development.md) || Monorepo | pnpm workspaces, centralized alias, Turborepo | [monorepo](references/monorepo.md) |

Frequently asked questions