diff --git a/AGENTS.md b/AGENTS.md
index 43e3d4dd9cc..09932ce7910 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,7 @@
 # Superset Monorepo Guide
 
+You're running inside a Superset workspace — an isolated git-worktree copy of this repo. "Workspace" in any user message refers to this, not VS Code/editor workspaces.
+
 ## Question Tool
 
 When you need to ask the user ANY question — including simple yes/no, confirmations, and clarifications — ALWAYS use the `ask_user` tool. Never ask questions in plain text. The Superset UI renders `ask_user` calls as an interactive overlay with clickable option buttons; plain-text questions will not be surfaced to the user in the same way.
diff --git a/skills/superset/SKILL.md b/skills/superset/SKILL.md
index 02ef88b2914..3bcf0e31c39 100644
--- a/skills/superset/SKILL.md
+++ b/skills/superset/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: superset
-description: Drives the Superset CLI to orchestrate coding agents across devices. Use when the user wants to spawn an agent, create or manage workspaces, schedule automations, or interact with Superset projects, hosts, or tasks from the terminal.
+description: Create workspaces, spawn agents, schedule automations, and manage Superset projects/tasks/hosts via the `superset` CLI. Use to orchestrate coding agents across devices from the terminal.
 allowed-tools: Bash(superset:*)
 ---