Skip to content

Conversation

@soderlind
Copy link
Owner

This pull request introduces a new skills system to both ralph.sh and ralph-once.sh, allowing users to prepend reusable skill instructions to the context for prompt runs. It also improves the test harness with filtering and better handling of WordPress skill staging, and adds vendored WordPress skills for plugin development and project triage. The documentation has been updated to reflect these changes.

Skills system and CLI enhancements:

  • Added --skill <a[,b,...]> option to ralph.sh and ralph-once.sh to prepend skill instructions from skills/<name>/SKILL.md into the attached context. (Fd8d484dL2R2, [1] [2]
  • Vendored WordPress skills (wp-plugin-development and wp-project-triage) under test/skills/ for easier harness integration. [1] [2] [3]

Test harness improvements:

  • Added --only <prompt1[,prompt2...]> filter to test/run-prompts.sh to allow running selected prompt tests. [1] [2] [3]
  • WordPress skill staging in the harness now copies from $ROOT/test/skills/... and stages those skills into a top-level skills/ folder inside the worktree for correct injection and assertion. [1] [2]

Documentation updates:

  • Updated CHANGELOG.md and README.md to document the new skills system, CLI options, and test harness features. [1] [2]

- 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.
@soderlind soderlind merged commit 1c8e8ae into main Jan 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants