From 6a7c296d341291d8a773846df9846cc0ba62d18b Mon Sep 17 00:00:00 2001
From: Alex Alecu <a.marian.alexandru@gmail.com>
Date: Tue, 7 Apr 2026 10:59:54 +0300
Subject: [PATCH] fix(cli): widen kilo-config skill to cover path location
 questions

The skill description and opening paragraph now explicitly mention
locating config/command/agent/skill paths across global, project,
and legacy directories (.kilo/, .kilocode/, .opencode/, ~/.config/kilo/).
This ensures the agent loads the skill for 'where is this command?'
prompts, not just configure/customize prompts.
---
 packages/opencode/src/kilocode/skills/builtin.ts     | 2 +-
 packages/opencode/src/kilocode/skills/kilo-config.md | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/opencode/src/kilocode/skills/builtin.ts b/packages/opencode/src/kilocode/skills/builtin.ts
index 9172a39cf95..96accd8f5ad 100644
--- a/packages/opencode/src/kilocode/skills/builtin.ts
+++ b/packages/opencode/src/kilocode/skills/builtin.ts
@@ -15,7 +15,7 @@ export const BUILTIN_SKILLS: BuiltinSkill[] = [
   {
     name: "kilo-config",
     description:
-      "Guide for configuring Kilo CLI: commands, agents, MCP servers, skills, permissions, instructions, plugins, providers, all kilo.json fields, and TUI settings (themes, appearance, keybinds, ctrl+p commands). Use when the user asks about configuring, customizing, or changing settings in Kilo.",
+      "Guide for configuring Kilo CLI and locating config, command, agent, and skill paths (global, project, legacy), plus MCP servers, permissions, instructions, plugins, providers, kilo.json fields, and TUI settings (themes, appearance, keybinds, ctrl+p commands). Use when the user asks about configuring Kilo, where it loads things from, or how to change settings.",
     content: KILO_CONFIG,
   },
 ]
diff --git a/packages/opencode/src/kilocode/skills/kilo-config.md b/packages/opencode/src/kilocode/skills/kilo-config.md
index e34a77f7518..cc2540678f8 100644
--- a/packages/opencode/src/kilocode/skills/kilo-config.md
+++ b/packages/opencode/src/kilocode/skills/kilo-config.md
@@ -2,6 +2,8 @@
 
 All config lives in `kilo.json` (or `kilo.jsonc`). Precedence low-to-high: remote well-known, global (`~/.config/kilo/kilo.json`), env `KILO_CONFIG`, project `./kilo.json`, `.kilo/kilo.json`, `KILO_CONFIG_CONTENT`, managed (see Config File Locations). Deep-merged; later wins.
 
+This also covers where Kilo looks for config files, commands, agents, and skills across project, global, and legacy paths such as `.kilo/`, `.kilocode/`, `.opencode/`, and `~/.config/kilo/`.
+
 ## Commands (`.kilo/command/*.md`)
 
 Markdown files with YAML frontmatter. The filename (minus `.md`) becomes the command name invoked via `/name`. Also loaded from `.kilocode/` and `.opencode/` directories (legacy), and plural `commands/` variants. See Config File Locations for the full search order.