Scaffold AI agent skills quickly with npx build-skill. Creates a fully-configured skills repository following the Agent Skills Specification.

Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. They work across any AI agent that supports the open Agent Skills standard.

npx build-skill

This launches an interactive prompt to configure your skill.

npx build-skill

You'll be prompted for:

• Brand/Organization name - Your company or project name (e.g., acme-corp)
• Skill name - Name of your first skill (e.g., data-processor)
• Skill description - What the skill does and when to use it

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

# Interactive mode
npx build-skill

# Specify brand and skill name
npx build-skill --brand acme-corp --name data-processor --description "Processes data files"

# Full configuration
npx build-skill \
  --brand acme-corp \
  --name data-processor \
  --description "Processes CSV and JSON data files" \
  --license Apache-2.0 \
  --website https://acme.example.com/docs \
  --repository acme-corp/agent-skills \
  --keywords "data, csv, json, processing" \
  --quiet

# Overwrite existing directory
npx build-skill --name my-skill --description "My skill" --force --quiet

<brand>-skills/
├── .claude-plugin/
│   └── marketplace.json
├── .github/
│   └── workflows/
│       └── process-skills.yml
├── scripts/
│   ├── add-skill.js
│   └── sync-skills.js
├── skills/
│   └── <skill-name>/
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── SKILL.md
└── README.md

The generated repository includes a process-skills.yml workflow that:

• On Pull Requests: Validates all skills using the Validate Agent Skill action
• On Push to Main: Validates skills and syncs the README, marketplace.json, and each skill's plugin.json

The scripts/add-skill.js utility creates new skills:

node scripts/add-skill.js <skill-name> "<description>"

Example:

node scripts/add-skill.js data-processor "Processes CSV and JSON data files"

This script:

• Creates the skill directory structure in skills/
• Generates SKILL.md with frontmatter
• Generates .claude-plugin/plugin.json
• Automatically runs sync-skills.js to update README and marketplace.json

The scripts/sync-skills.js utility keeps your repository in sync:

node scripts/sync-skills.js

This script:

• Scans the skills/ directory for all skills
• Updates the "Available Skills" table in README.md
• Updates the plugins array in .claude-plugin/marketplace.json

Run it after modifying skills to keep everything up to date.

General

• Agent Skills Specification
• Validate Agent Skill
• Why Use Build Skill?

Find and Install Agent Skills

• npx skills
• Playbooks
• Context7 Skills

Contributions are welcome! Please read our Contributing Guide for more information.

MIT License

Ben Sabic at Flash Brew Digital