From 30ea6438aeb7b0ebe655a2d93e00f080a1567d12 Mon Sep 17 00:00:00 2001 From: ruben-cytonic Date: Thu, 12 Feb 2026 04:27:08 +0000 Subject: [PATCH] fix(skills): make auto-install opt-in --- docs/docs/cli/skill.md | 14 +++++++++++--- src/skills/auto-install.ts | 3 ++- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/docs/cli/skill.md b/docs/docs/cli/skill.md index ea286a5..25f5c71 100644 --- a/docs/docs/cli/skill.md +++ b/docs/docs/cli/skill.md @@ -125,9 +125,17 @@ and included in the agent's prompt context when relevant. ## Auto Skill Discovery -When running a task, ralph-starter can also query the skills.sh -registry to find and install relevant skills automatically. -If you want to disable this behavior, set: +Auto skill discovery is opt-in. When enabled, ralph-starter +queries the skills.sh registry to find and install relevant +skills automatically. + +Enable it by setting: + +```bash +RALPH_ENABLE_SKILL_AUTO_INSTALL=1 +``` + +You can also force-disable it with: ```bash RALPH_DISABLE_SKILL_AUTO_INSTALL=1 diff --git a/src/skills/auto-install.ts b/src/skills/auto-install.ts index 1f8a76a..6697dc3 100644 --- a/src/skills/auto-install.ts +++ b/src/skills/auto-install.ts @@ -129,7 +129,8 @@ async function installSkill(candidate: SkillCandidate, globalInstall: boolean): export async function autoInstallSkillsFromTask(task: string, cwd: string): Promise { if (!task.trim()) return []; - if (process.env.RALPH_DISABLE_SKILL_AUTO_INSTALL === '1') return []; + const autoInstallEnabled = process.env.RALPH_ENABLE_SKILL_AUTO_INSTALL === '1'; + if (!autoInstallEnabled || process.env.RALPH_DISABLE_SKILL_AUTO_INSTALL === '1') return []; const queries = buildSkillQueries(task); if (queries.length === 0) return [];