From d91f4d21e2d3f8e380f46bde197302cfa3a881d8 Mon Sep 17 00:00:00 2001 From: jjroelofs <904576+jjroelofs@users.noreply.github.com> Date: Thu, 15 Oct 2026 08:01:30 +0200 Subject: [PATCH] Route the RL skills on their descriptions The rl, rl_page_title and rl_menu_link skills kept their routing words in a `triggers:` list, which Claude Code does not read: it chooses a skill from the description alone, and current Claude models follow that text literally. Nothing in this repository reads the key either. Remove it and rewrite each description to say what the skill does and when to use it. Move the non-standard top-level `version` key under `metadata`, as the Agent Skills specification requires. RlSetupCommands only copies and compares the files, so no code reads it. Fixes #71 Co-Authored-By: Claude Opus 5.5 --- .agents/skills/rl/SKILL.md | 21 +++++++------------ .claude/skills/rl/SKILL.md | 21 +++++++------------ .../.agents/skills/rl_menu_link/SKILL.md | 20 +++++++----------- .../.claude/skills/rl_menu_link/SKILL.md | 20 +++++++----------- .../.agents/skills/rl_page_title/SKILL.md | 20 +++++++----------- .../.claude/skills/rl_page_title/SKILL.md | 20 +++++++----------- 6 files changed, 48 insertions(+), 74 deletions(-) diff --git a/.agents/skills/rl/SKILL.md b/.agents/skills/rl/SKILL.md index 26fde07..0607cb4 100644 --- a/.agents/skills/rl/SKILL.md +++ b/.agents/skills/rl/SKILL.md @@ -1,19 +1,14 @@ --- name: rl -version: 1.0.0 description: > - Manage Reinforcement Learning (A/B testing) experiments via Drush CLI. - Thompson Sampling multi-armed bandit experiments: create, analyze, - configure, and optimize content variants. -triggers: - - /rl - - experiment - - a/b test - - ab test - - bandit - - thompson sampling - - conversion rate - - variant + Manage A/B testing experiments run by the RL module (Thompson + Sampling multi-armed bandits) with drush rl:* commands: list, + inspect, analyze, create, update or delete experiments and tune + module settings. Use it when a task mentions experiments, A/B or + multivariate tests, variants, bandits, conversion rates, or which + variant is winning. +metadata: + version: "1.0.0" --- # RL: Reinforcement Learning Experiments diff --git a/.claude/skills/rl/SKILL.md b/.claude/skills/rl/SKILL.md index 26fde07..0607cb4 100644 --- a/.claude/skills/rl/SKILL.md +++ b/.claude/skills/rl/SKILL.md @@ -1,19 +1,14 @@ --- name: rl -version: 1.0.0 description: > - Manage Reinforcement Learning (A/B testing) experiments via Drush CLI. - Thompson Sampling multi-armed bandit experiments: create, analyze, - configure, and optimize content variants. -triggers: - - /rl - - experiment - - a/b test - - ab test - - bandit - - thompson sampling - - conversion rate - - variant + Manage A/B testing experiments run by the RL module (Thompson + Sampling multi-armed bandits) with drush rl:* commands: list, + inspect, analyze, create, update or delete experiments and tune + module settings. Use it when a task mentions experiments, A/B or + multivariate tests, variants, bandits, conversion rates, or which + variant is winning. +metadata: + version: "1.0.0" --- # RL: Reinforcement Learning Experiments diff --git a/modules/rl_menu_link/.agents/skills/rl_menu_link/SKILL.md b/modules/rl_menu_link/.agents/skills/rl_menu_link/SKILL.md index 4b9474c..fde0403 100644 --- a/modules/rl_menu_link/.agents/skills/rl_menu_link/SKILL.md +++ b/modules/rl_menu_link/.agents/skills/rl_menu_link/SKILL.md @@ -1,18 +1,14 @@ --- name: rl_menu_link -version: 1.0.0 description: > - A/B test Drupal menu link labels using Thompson Sampling. Works for - both menu_link_content entities and YAML-defined links. Per-language - scoping. Manage experiments via Drush CLI. -triggers: - - /rl-menu-link - - menu link test - - menu label test - - menu variant - - a/b test menu - - test menu link - - rl_menu_link + A/B test Drupal menu link labels, for both menu_link_content + entities and YAML-defined links, with the RL module's Thompson + Sampling, scoped per language, through drush rl:menu-link:* commands: + list, inspect, create, update or delete label experiments. Use it + when a task asks to test or compare menu labels or navigation + wording, or mentions menu link variants. +metadata: + version: "1.0.0" --- # RL Menu Link: Drush CLI diff --git a/modules/rl_menu_link/.claude/skills/rl_menu_link/SKILL.md b/modules/rl_menu_link/.claude/skills/rl_menu_link/SKILL.md index 4b9474c..fde0403 100644 --- a/modules/rl_menu_link/.claude/skills/rl_menu_link/SKILL.md +++ b/modules/rl_menu_link/.claude/skills/rl_menu_link/SKILL.md @@ -1,18 +1,14 @@ --- name: rl_menu_link -version: 1.0.0 description: > - A/B test Drupal menu link labels using Thompson Sampling. Works for - both menu_link_content entities and YAML-defined links. Per-language - scoping. Manage experiments via Drush CLI. -triggers: - - /rl-menu-link - - menu link test - - menu label test - - menu variant - - a/b test menu - - test menu link - - rl_menu_link + A/B test Drupal menu link labels, for both menu_link_content + entities and YAML-defined links, with the RL module's Thompson + Sampling, scoped per language, through drush rl:menu-link:* commands: + list, inspect, create, update or delete label experiments. Use it + when a task asks to test or compare menu labels or navigation + wording, or mentions menu link variants. +metadata: + version: "1.0.0" --- # RL Menu Link: Drush CLI diff --git a/modules/rl_page_title/.agents/skills/rl_page_title/SKILL.md b/modules/rl_page_title/.agents/skills/rl_page_title/SKILL.md index 0ec4fdf..5d14b44 100644 --- a/modules/rl_page_title/.agents/skills/rl_page_title/SKILL.md +++ b/modules/rl_page_title/.agents/skills/rl_page_title/SKILL.md @@ -1,18 +1,14 @@ --- name: rl_page_title -version: 1.0.0 description: > - A/B test page titles for any Drupal page (nodes, Views displays, custom - controllers, any path) using Thompson Sampling. Per-language scoping. - Manage experiments via Drush CLI. -triggers: - - /rl-page-title - - page title test - - title experiment - - title variant - - a/b test page title - - test page title - - rl_page_title + A/B test the page title of any Drupal path (nodes, Views displays, + custom controllers) with the RL module's Thompson Sampling, scoped + per language, through drush rl:page-title:* commands: list, inspect, + create, update or delete title experiments. Use it when a task asks + to test, compare or optimise the title shown for a page, or mentions + page title variants. +metadata: + version: "1.0.0" --- # RL Page Title: Drush CLI diff --git a/modules/rl_page_title/.claude/skills/rl_page_title/SKILL.md b/modules/rl_page_title/.claude/skills/rl_page_title/SKILL.md index 0ec4fdf..5d14b44 100644 --- a/modules/rl_page_title/.claude/skills/rl_page_title/SKILL.md +++ b/modules/rl_page_title/.claude/skills/rl_page_title/SKILL.md @@ -1,18 +1,14 @@ --- name: rl_page_title -version: 1.0.0 description: > - A/B test page titles for any Drupal page (nodes, Views displays, custom - controllers, any path) using Thompson Sampling. Per-language scoping. - Manage experiments via Drush CLI. -triggers: - - /rl-page-title - - page title test - - title experiment - - title variant - - a/b test page title - - test page title - - rl_page_title + A/B test the page title of any Drupal path (nodes, Views displays, + custom controllers) with the RL module's Thompson Sampling, scoped + per language, through drush rl:page-title:* commands: list, inspect, + create, update or delete title experiments. Use it when a task asks + to test, compare or optimise the title shown for a page, or mentions + page title variants. +metadata: + version: "1.0.0" --- # RL Page Title: Drush CLI