Recommend

2. Search the local source code first

This is the fastest and most accurate way to find functions. Search across es-toolkit's categories:

# Search in src/ for matching function names or descriptions
Grep for keywords in src/{category}/*.ts

List subdirectories under src/ (excluding _internal and compat) to discover the current categories dynamically. You can also browse docs/reference/ to discover the full function index — each subdirectory is a category, and each .md file is a function.

Read the implementation file to get the exact signature, and the spec file for real usage examples.

3. Construct the official doc URL

es-toolkit's documentation URLs follow a predictable pattern — construct them directly instead of fetching:

• https://es-toolkit.dev/reference/{category}/{functionName}

4. Search local docs when you're unsure

If you can't find a matching function locally or want to discover functions you might be missing:

• Browse by category: Glob docs/reference/{category}/*.md to list all functions in a category
• Search by keyword: Grep for the keyword across docs/reference/**/*.md
• Available categories: array, error, function, map, math, object, predicate, promise, set, string, util

5. Respond with this structure

For each recommended function, include:

• Function name and category
• Import path: import { fn } from 'es-toolkit';
• Doc link: https://es-toolkit.dev/reference/{category}/{fn}
• What it does (from JSDoc in source)
• A code example (from spec file or official docs)
• Why it fits the user's need

When recommending multiple functions, always include a comparison table:

Add a "When to choose which" section with clear decision criteria — e.g., "Use groupBy for categorizing, countBy for tallying, keyBy for lookup maps."

If no match exists, say so clearly and suggest modern JS alternatives. For lodash-compatible replacements, point users to the /es-toolkit:migrate skill.