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