antfu/skills-npm

Registry

Summary

A TypeScript tool for installing Claude Skills directly from npm packages, enabling easy integration of agent capabilities.

Key features

• Install Claude Skills from npm
• TypeScript implementation
• Simple integration process
• Direct package management

Use cases

• Adding agent capabilities to projects
• Managing Claude Skill dependencies
• Streamlining AI tool integration
• Sharing reusable AI skills

README excerpt

# skills-npm [![npm version][npm-version-src]][npm-version-href] [![npm downloads][npm-downloads-src]][npm-downloads-href] [![bundle][bundle-src]][bundle-href] [![JSDocs][jsdocs-src]][jsdocs-href] [![License][license-src]][license-href] A CLI that discovers [agent skills](https://agentskills.io) shipped inside npm packages and creates symlinks for coding agents to consume. ## Why? Current skill distribution approaches (e.g. [`@vercel-labs/skills`](https://github.com/vercel-labs/skills)) have friction: - **Git-only source** - Only supports git repos as skills source - **Version mismatch** - Skills and tools update separately, causing compatibility issues - **Manual management** - Cloning skills from git repos requires extra steps per project - **Sharing overhead** - Teams must commit cloned files or repeat setup on each machine This project proposes a convention: **ship skills inside npm packages**. When you `npm install` a tool, its skills come bundled. Run `skills-npm` to symlink them for your agent. **Read the full proposal: [PROPOSAL.md](./PROPOSAL.md)** ## Usage ```bash npm i -D skills-npm ``` Add a `prepare` script to your `package.json` so the skills are symlinked automatically for your agent whenever you install dependencies: ```json { "private": true, "scripts": { "prepare": "skills-npm" } } ``` `skills-npm` will symbol links the skills from `node_modules` to `skills/npm-<package-name>-<skill-name>` for your agent. It's recommend to add the following to your `.gitignore`: ``` skills/npm-* ``` ## Configuration You can create a `skills-npm.config.ts` file in your project root to configure the behavior: ```ts // skills-npm.config.ts import { defineConfig } from 'skills-npm' export default defineConfig({ // Source to discover skills from

Topics

No topics yet.