wpboilerplate-skills-manager

Interactive CLI to manage WordPress Agent Skills in any WordPress plugin project.

Features

• 🔍 Live fetch — fetches the latest available skills from GitHub on every run
• ✅ Installed status — shows which skills are already in your project
• 📦 Multi-source — add extra skill sources via skills.config.json
• ⚙️ Configurable — override defaults with your own sources

Requirements

• Node.js 18+
• Git (for skillpack-based installs)

Installation

npm install --save-dev wpboilerplate-skills-manager

Then add to your package.json scripts:

{
  "scripts": {
    "skills": "wpb-skills",
    "skills:install": "wpb-skills-install"
  }
}

Usage

Interactive manager (recommended)

npm run skills

Fetches available skills, shows what's installed / not installed, and lets you pick what to add.

Install or update all skills

npm run skills:install

Clones the official WordPress agent-skills repo, builds with skillpack, and installs everything into .github/skills/.

Install specific skills

npx wpb-skills-install blueprint wordpress-router

Default source

Included out of the box — no config file needed:

Source	Repo	Installer
WordPress Agent Skills	WordPress/agent-skills	skillpack

Custom sources (skills.config.json)

Create a skills.config.json in your project root to override or extend the default sources:

{
  "sources": [
    {
      "name": "WordPress Agent Skills",
      "repo": "WordPress/agent-skills",
      "skillsPath": "skills",
      "installer": "skillpack"
    },
    {
      "name": "WPBoilerplate Agent Skills",
      "repo": "WPBoilerplate/agent-skills",
      "skillsPath": "skills",
      "installer": "copy"
    }
  ]
}

Note: A project-level skills.config.json fully replaces the default config. Include all sources you want.

Installer types

Type	When to use
skillpack	Repo ships shared/scripts/skillpack-build.mjs (e.g. WordPress/agent-skills)
copy	Plain skill directories — downloaded directly via GitHub Contents API

Where skills are installed

Skills are installed to .github/skills/ in the directory where you run the command (process.cwd()).

VS Code and GitHub Copilot automatically discover skills in .github/skills/.

License

GPL-3.0-or-later