feat: Add WP Plugin Development and Project Triage Skills

- Created `test/skills/wp-plugin-development/SKILL.md` to define the skill for developing WordPress plugins, detailing architecture, hooks, activation/deactivation, admin UI, security, and release packaging.
- Added references for various aspects of plugin development:
  - `references/data-and-cron.md`: Guidelines for data storage, cron tasks, and upgrade routines.
  - `references/debugging.md`: Quick debugging routes for common issues like plugin loading failures and settings not saving.
  - `references/lifecycle.md`: Instructions for managing activation, deactivation, and uninstall hooks.
  - `references/security.md`: Security best practices for plugins, including nonces, sanitization, and escaping.
  - `references/settings-api.md`: Guidelines for using the Settings API for admin options.
  - `references/structure.md`: Best practices for plugin structure and loading.

- Introduced `test/skills/wp-plugin-development/scripts/detect_plugins.mjs` to detect WordPress plugins in a repository by scanning PHP files for plugin headers.

- Created `test/skills/wp-project-triage/SKILL.md` to define the skill for inspecting WordPress repositories, including tooling, tests, and version hints.

- Added `test/skills/wp-project-triage/references/triage.schema.json` to provide a JSON schema for the project triage report.

- Implemented `test/skills/wp-project-triage/scripts/detect_wp_project.mjs` to analyze the repository structure, detect project types, and generate a structured report with recommendations based on the findings.

Author: soderlind

CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.0] - 2026-01-12
+
+### Added
+- `--skill <a[,b,...]>` support in `ralph.sh` and `ralph-once.sh` (prepends `skills/<name>/SKILL.md` into the attached context).
+- `--only <prompt1[,prompt2...]>` filter in `test/run-prompts.sh` to run selected prompt tests.
+- Vendored WordPress skills under `test/skills/` for the harness:
+
+  - `wp-plugin-development`
+  - `wp-project-triage`
+
+### Fixed
+- `test/run-prompts.sh`: WordPress skill staging now copies from `$ROOT/test/skills/...` (so it works inside per-prompt worktrees).
+- `test/run-prompts.sh`: WordPress assertions/skill injection now match `wordpress-plugin-agent.txt` consistently.
+
+### Changed
+- `test/run-prompts.sh`: WordPress prompt test now stages those vendored skills into a top-level `skills/` folder inside the worktree and injects the WP plugin skill into the context attachment.
+
 ## [1.0.0] - 2026-01-10
 
 ### Added

README.md

@@ -140,6 +140,7 @@ MODEL=claude-opus-4.5 ./ralph-once.sh --prompt prompts/default.txt --prd plans/p
 |--------------------------|--------------------------------------|-----------------------|
 | `--prompt <file>`        | Load prompt from file (required)     | —                     |
 | `--prd <file>`           | Optionally attach a PRD JSON file    | —                     |
+| `--skill <a[,b,...]>`    | Prepend skills from `skills/<name>/SKILL.md` | —              |
 | `--allow-profile <name>` | Permission profile (see below)       | —                     |
 | `--allow-tools <spec>`   | Allow specific tool (repeatable)     | —                     |
 | `--deny-tools <spec>`    | Deny specific tool (repeatable)      | —                     |
@@ -271,6 +272,24 @@ Ralph always denies a small set of dangerous commands (currently `shell(rm)` and
 - Single attachment workaround: Ralph combines PRD + `progress.txt` into one context file to avoid Copilot CLI issues with multiple `@file` attachments.
 - Pseudo-TTY capture in the harness: `test/run-prompts.sh` uses `script(1)` to capture output even when Copilot writes directly to the TTY.
 
+### Skills (`--skill`)
+
+Skills let you prepend reusable instructions into the same attached context file.
+Pass a comma-separated list (repeatable):
+
+- `--skill wp-block-development` loads `skills/wp-block-development/SKILL.md`
+- `--skill aa,bb,cc` loads `skills/aa/SKILL.md`, `skills/bb/SKILL.md`, `skills/cc/SKILL.md`
+
+Example:
+
+```bash
+./ralph.sh --prompt prompts/wordpress-plugin-agent.txt \
+  --skill wp-block-development,wp-cli \
+  --prd plans/prd.json \
+  --allow-profile safe \
+  5
+```
+
 ---
 
 

ralph-once.sh

@@ -1,18 +1,19 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-RALPH_VERSION="1.0.0"
+RALPH_VERSION="1.1.0"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 usage() {
    cat <<USAGE
 Usage:
-   $0 --prompt <file> [--prd <file>] [--allow-profile <safe|dev|locked>] [--allow-tools <toolSpec> ...] [--deny-tools <toolSpec> ...]
+   $0 --prompt <file> [--prd <file>] [--skill <a[,b,...]>] [--allow-profile <safe|dev|locked>] [--allow-tools <toolSpec> ...] [--deny-tools <toolSpec> ...]
 
 Options:
    --prompt <file>           Load prompt text from file (required).
    --prd <file>              Optionally attach a PRD JSON file.
+   --skill <a[,b,...]>       Prepend one or more skills from skills/<name>/SKILL.md (comma-separated).
    --allow-profile <name>    Tool permission profile: safe | dev | locked.
    --allow-tools <toolSpec>  Allow a specific tool (repeatable). Example: --allow-tools write
                                           Use quotes if the spec includes spaces: --allow-tools 'shell(git push)'
@@ -26,12 +27,20 @@ USAGE
 
 prompt_file=""
 prd_file=""
+skills_csv=""
 allow_profile=""
 declare -a allow_tools
 declare -a deny_tools
 allow_tools=()
 deny_tools=()
 
+trim() {
+   local s="$1"
+   s="${s#"${s%%[![:space:]]*}"}"
+   s="${s%"${s##*[![:space:]]}"}"
+   printf '%s' "$s"
+}
+
 while [[ $# -gt 0 ]]; do
    case "$1" in
       --prompt)
@@ -63,6 +72,34 @@ while [[ $# -gt 0 ]]; do
          fi
          shift
          ;;
+      --skill)
+         shift
+         if [[ $# -lt 1 || -z "${1:-}" ]]; then
+            echo "Error: --skill requires a value" >&2
+            usage
+            exit 1
+         fi
+         if [[ -n "$skills_csv" ]]; then
+            skills_csv+=",$1"
+         else
+            skills_csv="$1"
+         fi
+         shift
+         ;;
+      --skill=*)
+         v="${1#--skill=}"
+         if [[ -z "$v" ]]; then
+            echo "Error: --skill requires a value" >&2
+            usage
+            exit 1
+         fi
+         if [[ -n "$skills_csv" ]]; then
+            skills_csv+=",$v"
+         else
+            skills_csv="$v"
+         fi
+         shift
+         ;;
       --allow-profile)
          shift
          if [[ $# -lt 1 || -z "${1:-}" ]]; then
@@ -139,6 +176,12 @@ if [[ ! -r "$progress_file" ]]; then
    exit 1
 fi
 
+declare -a skills
+skills=()
+if [[ -n "$skills_csv" ]]; then
+   IFS=',' read -r -a skills <<<"$skills_csv"
+fi
+
 if [[ -z "$allow_profile" ]] && [[ ${#allow_tools[@]} -eq 0 ]]; then
    echo "Error: you must specify --allow-profile or at least one --allow-tools" >&2
    usage
@@ -196,6 +239,25 @@ context_file="$(mktemp .ralph-context.XXXXXX)"
 {
    echo "# Context"
    echo
+   if [[ ${#skills[@]} -gt 0 ]]; then
+      echo "## Skills"
+      for raw in "${skills[@]}"; do
+         skill="$(trim "$raw")"
+         if [[ -z "$skill" ]]; then
+            continue
+         fi
+         skill_file="skills/$skill/SKILL.md"
+         if [[ ! -r "$skill_file" ]]; then
+            echo "Error: skill not found/readable: $skill_file" >&2
+            exit 1
+         fi
+         echo
+         echo "### $skill"
+         echo
+         cat "$skill_file"
+      done
+      echo
+   fi
    if [[ -n "$prd_file" ]]; then
       echo "## PRD ($prd_file)"
       cat "$prd_file"

ralph.sh

@@ -1,18 +1,19 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-RALPH_VERSION="1.0.0"
+RALPH_VERSION="1.1.0"
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 usage() {
   cat <<USAGE
 Usage:
-  $0 --prompt <file> [--prd <file>] [--allow-profile <safe|dev|locked>] [--allow-tools <toolSpec> ...] [--deny-tools <toolSpec> ...] <iterations>
+  $0 --prompt <file> [--prd <file>] [--skill <a[,b,...]>] [--allow-profile <safe|dev|locked>] [--allow-tools <toolSpec> ...] [--deny-tools <toolSpec> ...] <iterations>
 
 Options:
   --prompt <file>           Load prompt text from file (required).
   --prd <file>              Optionally attach a PRD JSON file.
+  --skill <a[,b,...]>       Prepend one or more skills from skills/<name>/SKILL.md (comma-separated).
   --allow-profile <name>    Tool permission profile: safe | dev | locked.
   --allow-tools <toolSpec>  Allow a specific tool (repeatable). Example: --allow-tools write
                             Use quotes if the spec includes spaces: --allow-tools 'shell(git push)'
@@ -26,12 +27,20 @@ USAGE
 
 prompt_file=""
 prd_file=""
+skills_csv=""
 allow_profile=""
 declare -a allow_tools
 declare -a deny_tools
 allow_tools=()
 deny_tools=()
 
+trim() {
+  local s="$1"
+  s="${s#"${s%%[![:space:]]*}"}"
+  s="${s%"${s##*[![:space:]]}"}"
+  printf '%s' "$s"
+}
+
 while [[ $# -gt 0 ]]; do
   case "$1" in
     --prompt)
@@ -63,6 +72,34 @@ while [[ $# -gt 0 ]]; do
       fi
       shift
       ;;
+    --skill)
+      shift
+      if [[ $# -lt 1 || -z "${1:-}" ]]; then
+        echo "Error: --skill requires a value" >&2
+        usage
+        exit 1
+      fi
+      if [[ -n "$skills_csv" ]]; then
+        skills_csv+=",$1"
+      else
+        skills_csv="$1"
+      fi
+      shift
+      ;;
+    --skill=*)
+      v="${1#--skill=}"
+      if [[ -z "$v" ]]; then
+        echo "Error: --skill requires a value" >&2
+        usage
+        exit 1
+      fi
+      if [[ -n "$skills_csv" ]]; then
+        skills_csv+=",$v"
+      else
+        skills_csv="$v"
+      fi
+      shift
+      ;;
     --allow-profile)
       shift
       if [[ $# -lt 1 || -z "${1:-}" ]]; then
@@ -151,6 +188,12 @@ if [[ ! -r "$progress_file" ]]; then
   exit 1
 fi
 
+declare -a skills
+skills=()
+if [[ -n "$skills_csv" ]]; then
+  IFS=',' read -r -a skills <<<"$skills_csv"
+fi
+
 if [[ -z "$allow_profile" ]] && [[ ${#allow_tools[@]} -eq 0 ]]; then
   echo "Error: you must specify --allow-profile or at least one --allow-tools" >&2
   usage
@@ -209,6 +252,25 @@ for ((i=1; i<=iterations; i++)); do
   {
     echo "# Context"
     echo
+    if [[ ${#skills[@]} -gt 0 ]]; then
+      echo "## Skills"
+      for raw in "${skills[@]}"; do
+        skill="$(trim "$raw")"
+        if [[ -z "$skill" ]]; then
+          continue
+        fi
+        skill_file="skills/$skill/SKILL.md"
+        if [[ ! -r "$skill_file" ]]; then
+          echo "Error: skill not found/readable: $skill_file" >&2
+          exit 1
+        fi
+        echo
+        echo "### $skill"
+        echo
+        cat "$skill_file"
+      done
+      echo
+    fi
     if [[ -n "$prd_file" ]]; then
       echo "## PRD ($prd_file)"
       cat "$prd_file"