Install Agent Skills with npm

Add Agentuity skill guidance to an existing project with @agentuity/skills and skills-npm

Use npm-distributed Agent Skills when you want AI coding agents to load Agentuity guidance from project dependencies instead of a separate Git registry install.

Use the CLI

In an existing project:

agentuity skills install

The install command adds @agentuity/skills, skills-npm, skills-npm.config.ts, a prepare script, and .gitignore entries for generated skill symlinks. It then runs the detected package manager install and syncs the skills.

Use agentuity skills setup --no-sync if you only want to update project files before running your package manager manually.

Manual Setup

If you are not using the Agentuity CLI command:

npm install -D @agentuity/skills skills-npm

Create skills-npm.config.ts:

import { defineConfig } from 'skills-npm';
 
export default defineConfig({
  include: ['@agentuity/skills'],
});

Add a prepare script:

{
  "scripts": {
    "prepare": "skills-npm --yes"
  }
}

Run the sync:

npx skills-npm --yes

Verify

List the bundled skills:

agentuity skills list

Or inspect generated agent directories such as .cursor/skills/ or .agents/skills/, depending on which tools skills-npm detects.

Generated npm-* skill symlinks should stay out of git.

Next Steps