build-skill

library1.0.3jsnpmunverified

Scaffold AI agent skills quickly with the Build Skill CLI (build-skill v1.4.0). Creates a fully-configured skills repository following the Agent Skills Specification. Released monthly since February 2026 under MIT license by Flash Brew Digital. Differentiates from generic scaffolding tools by targeting AI agent skill structure, including GitHub Actions workflows, Claude plugin integration, and validation scripts out of the box. Requires Node.js >=20.

llm-agents devops

npm install build-skill

github ↗package ↗

INSTALL

IMPORT

SIG · BUILD-SKILL

build-skill

llm-agentsjavascriptv1.0.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

build-skill (CLI)

✓ npx build-skill

✗ npm install -g build-skill && build-skill

The recommended way is to use npx without installing globally. The package is a CLI tool, not a library, so it does not export JavaScript symbols.

TypeScript types

✓ import { BuildSkillOptions } from 'build-skill'

✗ const { BuildSkillOptions } = require('build-skill')

TypeScript type definitions are shipped but the package is primarily a CLI. The types are used for programmatic usage (if any) but are minimal.

Quickly scaffold an AI agent skill using npx in quiet mode with explicit parameters.

npx build-skill --name my-skill --description "Helps with X tasks" --quiet --output ./my-skill

build-skill --version

Debug

Known issues

gotchaNode.js >=20 is required, older versions may fail silently or throw errors.

fix

Upgrade Node.js to version 20 or later.

affects: >=1.0.0

breakingIn v1.3.0, keywords changed from a string to a JSON array. If using --keywords with a comma-separated string, it may cause validation errors.

fix

Pass keywords as a JSON array (e.g., --keywords '["ai","agent"]') or upgrade to v1.4.0 which accepts comma-separated strings again.

affects: >=1.3.0

gotchaThe --force flag overwrites existing directories without confirmation, which can lead to data loss.

fix

Ensure you have backups or use version control before running with --force.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Node.js version must be >=20

The engine requirement is enforced programmatically; running on older Node.js triggers this error.

fix

Install Node.js 20 or later (nvm install 20).

Error: The 'keywords' option must be a JSON array

In v1.3.0, keywords validation was strict, rejecting comma-separated strings.

fix

Upgrade to v1.4.0 or pass keywords as a JSON array, e.g., --keywords '["keyword1","keyword2"]'.

Error: ENOENT: no such file or directory, open '...skills/.../SKILL.md'

The output directory already exists but is missing required subdirectories, or the tool failed to create them.

fix

Use --force to overwrite or specify a different output directory with --output.

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Flash-Brew-Digital/build-skill ↗

packagehttps://www.npmjs.com/package/build-skill ↗