Package Exports

skill

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (skill) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

skill

skill is a small CLI for installing remote skill packages into a local CodeBuddy project.

It maps a package specifier such as skills/react-best-practices to a remote package under https://github.com/vercel-labs/agent-skills/tree/main/ and installs the result into .codebuddy/skills/.

Features

Install a skill with a single command
Write skills into .codebuddy/skills/<name>
Support single-file, manifest-based, and directory-listing packages
Replace an existing installation atomically
Work well in npx-first workflows

Requirements

Node.js 18 or newer

Installation

Run directly with npx:

npx skill skills/react-best-practices

Or install globally:

npm install -g skill
skill skills/react-best-practices

Quick Start

npx skill skills/web-design-guidelines

This downloads:

https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

and installs into:

.codebuddy/skills/web-design-guidelines

Typical CLI output:

Installed skills/web-design-guidelines
Source: https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines
Target: .codebuddy/skills/web-design-guidelines
Files: 3

Package Resolution

skill currently accepts package specifiers in this form:

skills/<name>

For example:

npx skill skills/demo
npx skill skills/react-best-practices
npx skill skills/web-design-guidelines

The default remote base URL is:

https://github.com/vercel-labs/agent-skills/tree/main

Supported Package Layouts

skill supports three remote layouts.

1. Single-file skill

https://github.com/vercel-labs/agent-skills/tree/main/skills/xxx

The GitHub directory only needs to contain SKILL.md.

2. Manifest-based multi-file skill

index.json or manifest.json can describe the package contents inside a GitHub skill directory:

{
  "files": ["SKILL.md", "notes.md", "assets/template.txt"]
}

The manifest must include SKILL.md.

3. Browseable directory listing

For GitHub-hosted skills, skill recursively fetches the full directory tree.

This is useful for real multi-file skills such as:

That lets skill download files such as:

SKILL.md
README.md
metadata.json
nested files under folders like rules/

Environment Variables

`SKILL_BASE_URL`

Override the remote base URL for another GitHub repository, a private deployment, local development, or testing:

SKILL_BASE_URL=https://github.com/your-org/agent-skills/tree/main npx skill skills/demo

Development

pnpm install
pnpm type-check
pnpm test
pnpm build
pnpm format

Publishing

Before publishing:

pnpm type-check
pnpm test
pnpm build
npm publish --dry-run

Then publish:

npm publish

If you later switch to a scoped package name, publish with:

npm publish --access public

License

MIT