diff --git a/.opencode/tools/ask262-evaluate-in-engine262.ts b/.opencode/tools/ask262-evaluate-in-engine262.ts
index 168fda8..d20da28 100644
--- a/.opencode/tools/ask262-evaluate-in-engine262.ts
+++ b/.opencode/tools/ask262-evaluate-in-engine262.ts
@@ -11,7 +11,9 @@ export default tool({
     "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. " +
     "Returns JSON with importantSections and otherSections arrays. " +
     "Use this to understand how specific JavaScript operations map to the ECMAScript spec. " +
-    "You can use ask262Debug.startImportant() and ask262Debug.stopImportant() in the code to mark important sections.",
+    "ask262Debug is available globally in the execution context (no import needed). " +
+    "Use ask262Debug.startImportant() and ask262Debug.stopImportant() to mark important sections. " +
+    "Example: ask262Debug.startImportant(); let x = 1 + 2; ask262Debug.stopImportant();",
   args: {
     code: tool.schema
       .string()
diff --git a/src/agent-tools/evaluateInEngine262.ts b/src/agent-tools/evaluateInEngine262.ts
index ba082c8..74fb255 100644
--- a/src/agent-tools/evaluateInEngine262.ts
+++ b/src/agent-tools/evaluateInEngine262.ts
@@ -42,7 +42,11 @@ export function createEvaluateInEngine262Tool() {
   return new DynamicStructuredTool({
     name: "ask262_evaluate_in_engine262",
     description:
-      "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. Returns the full marks array as JSON. Useful for understanding how specific JavaScript operations map to the ECMAScript spec.",
+      "Executes JavaScript code in the engine262 JavaScript engine and captures which ECMAScript specification sections are hit during execution. " +
+      "Returns the full marks array as JSON. Useful for understanding how specific JavaScript operations map to the ECMAScript spec. " +
+      "ask262Debug is available globally in the execution context (no import needed). " +
+      "Use ask262Debug.startImportant() and ask262Debug.stopImportant() to mark important sections. " +
+      "Example: ask262Debug.startImportant(); let x = 1 + 2; ask262Debug.stopImportant();",
     schema: evaluateSchema,
     func: async ({ code }) => {
       try {