Add Claude Code support to skillpack build and install scripts

- Add 'claude' target for project-level installation (.claude/skills/)
- Add 'claude-global' target for user-level installation (~/.claude/skills/)
- Add --global flag as shorthand for --targets=claude-global
- Add --skills flag for selective skill installation
- Add --list flag to show available skills
- Add --dry-run flag to preview installation
- Update README with Claude Code installation instructions

Author: Jameswlepage

README.md

@@ -36,6 +36,25 @@ Agent Skills solve this by giving AI assistants **expert-level WordPress knowled
 
 ## Quick Start
 
+### Install globally for Claude Code
+
+```bash
+# Clone agent-skills
+git clone https://github.com/Automattic/agent-skills.git
+cd agent-skills
+
+# Build the distribution
+node shared/scripts/skillpack-build.mjs --clean
+
+# Install all skills globally (available across all projects)
+node shared/scripts/skillpack-install.mjs --global
+
+# Or install specific skills only
+node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development
+```
+
+This installs skills to `~/.claude/skills/` where Claude Code will automatically discover them.
+
 ### Install into your repo
 
 ```bash
@@ -47,12 +66,26 @@ cd agent-skills
 node shared/scripts/skillpack-build.mjs --clean
 
 # Install into your WordPress project
-node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode
+node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude
 ```
 
 This copies skills into:
 - `.codex/skills/` for OpenAI Codex
 - `.github/skills/` for VS Code / GitHub Copilot
+- `.claude/skills/` for Claude Code (project-level)
+
+### Available options
+
+```bash
+# List available skills
+node shared/scripts/skillpack-install.mjs --list
+
+# Dry run (preview without installing)
+node shared/scripts/skillpack-install.mjs --global --dry-run
+
+# Install specific skills to a project
+node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude --skills=wp-wpcli-and-ops
+```
 
 ### Manual installation
 

shared/scripts/skillpack-build.mjs

@@ -5,11 +5,17 @@ function usage() {
   process.stderr.write(
     [
       "Usage:",
-      "  node shared/scripts/skillpack-build.mjs [--out=dist] [--targets=codex,vscode] [--clean]",
+      "  node shared/scripts/skillpack-build.mjs [--out=dist] [--targets=codex,vscode,claude] [--skills=skill1,skill2] [--clean]",
       "",
       "Outputs:",
       "  - <out>/codex/.codex/skills/<skill>/SKILL.md",
       "  - <out>/vscode/.github/skills/<skill>/SKILL.md",
+      "  - <out>/claude/.claude/skills/<skill>/SKILL.md",
+      "",
+      "Options:",
+      "  --targets    Comma-separated list of targets (codex, vscode, claude). Default: codex,vscode,claude",
+      "  --skills     Comma-separated list of skill names to build. Default: all skills",
+      "  --clean      Remove target directories before building",
       "",
       "Notes:",
       "- Avoids symlinks (Codex ignores symlinked directories).",
@@ -19,12 +25,13 @@ function usage() {
 }
 
 function parseArgs(argv) {
-  const args = { out: "dist", targets: ["codex", "vscode"], clean: false };
+  const args = { out: "dist", targets: ["codex", "vscode", "claude"], skills: [], clean: false };
   for (const a of argv) {
     if (a === "--help" || a === "-h") args.help = true;
     else if (a === "--clean") args.clean = true;
     else if (a.startsWith("--out=")) args.out = a.slice("--out=".length);
     else if (a.startsWith("--targets=")) args.targets = a.slice("--targets=".length).split(",").filter(Boolean);
+    else if (a.startsWith("--skills=")) args.skills = a.slice("--skills=".length).split(",").filter(Boolean);
     else {
       process.stderr.write(`Unknown arg: ${a}\n`);
       args.help = true;
@@ -91,6 +98,7 @@ function buildTarget({ repoRoot, outDir, target, skillDirs }) {
   const rootByTarget = {
     codex: path.join(outDir, "codex", ".codex", "skills"),
     vscode: path.join(outDir, "vscode", ".github", "skills"),
+    claude: path.join(outDir, "claude", ".claude", "skills"),
   };
   const destSkillsRoot = rootByTarget[target];
   assert(destSkillsRoot, `Unknown target: ${target}`);
@@ -107,6 +115,8 @@ function buildTarget({ repoRoot, outDir, target, skillDirs }) {
   process.stdout.write(`OK: built ${target} skillpack at ${rel}\n`);
 }
 
+const VALID_TARGETS = ["codex", "vscode", "claude"];
+
 function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.help) {
@@ -118,23 +128,31 @@ function main() {
   const skillsRoot = path.join(repoRoot, "skills");
   const outDir = path.isAbsolute(args.out) ? args.out : path.join(repoRoot, args.out);
 
-  const skillDirs = listSkillDirs(skillsRoot);
+  let skillDirs = listSkillDirs(skillsRoot);
   assert(skillDirs.length > 0, "No skills found under ./skills");
 
+  // Filter skills if --skills was specified
+  if (args.skills.length > 0) {
+    const requestedSkills = new Set(args.skills);
+    const availableSkills = skillDirs.map((d) => path.basename(d));
+
+    // Validate requested skills exist
+    for (const s of requestedSkills) {
+      assert(availableSkills.includes(s), `Unknown skill: ${s}. Available: ${availableSkills.join(", ")}`);
+    }
+
+    skillDirs = skillDirs.filter((d) => requestedSkills.has(path.basename(d)));
+  }
+
   const targets = [...new Set(args.targets)];
   for (const t of targets) {
-    assert(t === "codex" || t === "vscode", `Invalid target: ${t}`);
+    assert(VALID_TARGETS.includes(t), `Invalid target: ${t}. Valid targets: ${VALID_TARGETS.join(", ")}`);
   }
 
   if (args.clean) {
     for (const t of targets) {
-      const p =
-        t === "codex"
-          ? path.join(outDir, "codex")
-          : t === "vscode"
-            ? path.join(outDir, "vscode")
-            : null;
-      if (p) fs.rmSync(p, { recursive: true, force: true });
+      const targetDir = path.join(outDir, t);
+      fs.rmSync(targetDir, { recursive: true, force: true });
     }
   }