onmax/npm-agentskills

記録された最新のソース活動: 2026年1月11日 11:03

SkillsMP カタログ更新: 2026年11月9日 14:22

収集済み skills: 2

GitHub スター: 31
GitHub フォーク: 0

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/onmax/npm-agentskills.

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# npm-agentskills [![npm version](https://comark-ui.onmax.me/badge.svg?source=npm-version&package=npm-agentskills&icon=npm)](https://www.npmjs.com/package/npm-agentskills) [![npm downloads](https://comark-ui.onmax.me/badge.svg?source=npm-downloads&package=npm-agentskills&period=month&icon=npm)](https://www.npmjs.com/package/npm-agentskills) [![license](https://comark-ui.onmax.me/badge.svg?label=license&value=MIT)](https://github.com/onmax/npm-agentskills/blob/main/LICENSE) [![docs](https://comark-ui.onmax.me/badge.svg?label=docs&value=npm-agentskills)](https://github.com/onmax/npm-agentskills#readme) Bundle agent skills with your npm packages to help AI assistants understand your library. ## What Are Agent Skills? Agent Skills provide contextual documentation that AI coding assistants load automatically. When developers use your library, their AI agent reads your skill to deliver accurate guidance on your API, patterns, and best practices. Skills follow the [agentskills](https://agentskills.io) open format, supported by Claude Code, GitHub Copilot, Cursor, and other AI coding tools. This package enables library authors to bundle skills with their npm packages. When users install your package, their AI agent discovers and exports the skills to the appropriate location. ## Installation ```bash npm install npm-agentskills ``` ## For Library Authors: Bundling Skills Add an `agents` field to your `package.json` that points to skill directories: ```json { "name": "my-awesome-library", "agents": { "skills": [ { "name": "my-skill", "path": "./skills/my-skill" } ] } } ``` Create skill directories with a `SKILL.md` file: ``` skills/my-skill/ ├── SKILL.md # Required: entry point with frontmatter └── references/ # Optional: additional documentation files └── api.md ``` **Learn how to write skills:** See the [agentskills.io specification](https://agentskills.io/specification) for the complete guide on creating effective agent skills. ## For End Users: Installing Skills ### Nuxt Applications (Automatic) Add the module to your Nuxt config. The module automatically discovers skills from `node_modules` and exports them when you run `nuxi prepare` or `nuxi dev`: ```ts [nuxt.config.ts] export default defineNuxtConfig({ modules: ['npm-agentskills/nuxt'], agents: { targets: ['claude', 'cursor'], }, }) ``` The module scans your dependencies for packages with `agents` fields and exports their skills to project-local directories. ### Other Frameworks (CLI) Run the CLI after installing packages that contain skills: ```bash # Export skills to Claude Code npx agents export --target claude # Export to multiple agents npx agents export --target cursor npx agents export --target codex # List all discovered skills npx agents list ``` Add this to your `postinstall` script for automatic exports: ```json [package.json] { "scripts": { "postinstall": "agents export --target claude" } } ``` ## Supported Agents All paths are project-local, keeping skills scoped to your project rather than polluting global configuration. | Agent | Directory | Documentation | |------------|----------------------|---------------| | Claude | `.claude/skills/` | [docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/skills) | | Copilot | `.github/skills/` | [docs](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) | | Cursor | `.cursor/skills/` | [docs](https://cursor.com/docs/context/skills) | | Codex | `.codex/skills/` | [docs](https://developers.openai.com/codex/skills) | | OpenCode | `.opencode/skill/` | [docs](https://opencode.ai/docs/skills) | | Amp | `.agents/skills/` | [docs](https://ampcode.com/news/agent-skills) | | Goose | `.goose/skills/` | [docs](https://block.github.io/goose/docs/guides/context-engineering/using-skills) | ### Cross-Agent Compatibility Many agents read from multiple directories for compatibility: - **Goose** also reads `.claude/skills/` and `.agents/skills/` - **OpenCode** also reads `.claude/skills/` - **Amp** uses the portable `.agents/skills/` convention If you target `claude`, your skills will work with Goose and OpenCode automatically. ## Programmatic API Use the core functions directly in build tools or custom integrations: ```ts import { exportToTargets, generateManifest, resolveSkills, scanForSkillPackages, scanLocalPackage, } from 'npm-agentskills' // Scan node_modules for packages with agents field const packageSkills = await scanForSkillPackages('./node_modules') // Scan local package.json for skills defined in this project const localSkills = await scanLocalPackage('./') // Resolve and deduplicate skills const skills = await resolveSkills(packageSkills, localSkills) // Export to agent directories await exportToTargets(skills, ['claude', 'cursor'], './') // Generate manifest for debugging const manifest = generateManifest(skills) ``` ## CLI Reference ```bash # List all discovered skills with their sources agents list agents list --json # Output as JSON # Export skills to agent directory agents export --target claude agents export --target cursor agents export --dest ./custom-path # Custom destination # Options --cwd <dir> # Project root (default: current directory) --dir <dir> # Skills directory (default: node_modules/.cache/agentskills) ``` ## How It Works 1. **Discovery**: Scans `node_modules` for packages with an `agents` field in their `package.json` 2. **Resolution**: Reads each skill's `SKILL.md` file and parses the frontmatter metadata 3. **Export**: Copies skill directories to the appropriate agent location 4. **Manifest**: Generates a `manifest.json` file listing all discovered skills For Nuxt, the module handles this automatically during `nuxi prepare`. For other frameworks, you run the CLI manually or via npm scripts. ## Testing Your Skills Verify the tool discovers your skills correctly: ```bash # List discovered skills npx agents list # Export to agent directory npx agents export --target claude # Verify files exist ls -la .claude/skills/your-skill/ ``` ## License MIT

リポジトリの README を読み込んでいます…

このリポジトリの skills

ウェブ開発者ソフトウェア開発者

2 件の職業カテゴリ · 100% 分類済み

skill

職業分類

説明

更新

test-skill

ソフトウェア開発者

A test skill for validating npm-agentskills functionality

原文の言語: 英語

2026-01-11

nuxt-test-skill

ウェブ開発者

A test skill for validating npm-agentskills Nuxt integration

原文の言語: 英語

2026-01-11

収集済み skill 2 件中 2 件を表示しています。