antfu/skills-npm

What it solves

It eliminates the friction associated with distributing and managing "agent skills" (instructions or tools for AI coding agents). Instead of manually cloning skills from Git repositories—which often leads to version mismatches, setup overhead for teams, and manual maintenance—this tool allows skills to be bundled and shipped directly within npm packages.

How it works

skills-npm is a CLI tool that scans your project's node_modules or package.json to discover skills shipped by installed npm packages. It then creates symlinks from those packages to the configuration directories of your detected AI coding agents (such as Cursor or Windsurf). By integrating into the prepare script of a package.json, it ensures that skills are automatically re-synced whenever dependencies are installed.

Who it’s for

• Developers using AI coding agents who want a seamless way to install and update agent skills via npm.
• Package Authors who want to provide built-in skills for their tools so that users' AI agents can better interact with their software.

Highlights

• Automatic Discovery: Detects agent skills bundled in npm packages and automatically symlinks them.
• Agent Auto-detection: Identifies which coding agents are installed on the system by checking config directories and CLI paths.
• Seamless Integration: Uses the npm prepare hook to keep skills in sync with dependency updates.
• Flexible Configuration: Supports include/exclude filters, wildcard patterns for packages, and monorepo recursive scanning.