diff --git a/scripts/skill-generator/generate.js b/scripts/skill-generator/generate.js
index 37fbc8c..81556eb 100644
--- a/scripts/skill-generator/generate.js
+++ b/scripts/skill-generator/generate.js
@@ -15,7 +15,7 @@ async function main() {
   }
 
   await fsp.rm(OUTPUT_ROOT, { recursive: true, force: true });
-  await fsp.mkdir(path.join(OUTPUT_ROOT, "reference"), { recursive: true });
+  await fsp.mkdir(path.join(OUTPUT_ROOT, "references"), { recursive: true });
 
   const docFiles = await listDocFiles(DOCS_ROOT);
   const references = [];
@@ -33,7 +33,7 @@ async function main() {
     const markdown = convertDocToMarkdown(body);
 
     const referenceRelPath = `${stripExtension(relPath)}.md`;
-    const outputPath = path.join(OUTPUT_ROOT, "reference", referenceRelPath);
+    const outputPath = path.join(OUTPUT_ROOT, "references", referenceRelPath);
     await fsp.mkdir(path.dirname(outputPath), { recursive: true });
 
     const referenceFile = buildReferenceFile({
@@ -51,7 +51,7 @@ async function main() {
       title,
       description,
       canonicalUrl,
-      referencePath: `reference/${referenceRelPath}`,
+      referencePath: `references/${referenceRelPath}`,
     });
   }
 
diff --git a/scripts/skill-generator/template/SKILL.md b/scripts/skill-generator/template/SKILL.md
index 629b494..cb5d7d9 100644
--- a/scripts/skill-generator/template/SKILL.md
+++ b/scripts/skill-generator/template/SKILL.md
@@ -1,11 +1,11 @@
 ---
 name: "sandbox-agent"
-description: "Documentation and API reference for Sandbox Agent."
+description: "Deploy, configure, and integrate Sandbox Agent - a universal API for orchestrating AI coding agents (Claude Code, Codex, OpenCode, Amp) in sandboxed environments. Use when: (1) Setting up sandbox-agent server locally or in cloud sandboxes (E2B, Daytona, Docker), (2) Creating and managing agent sessions via SDK or API, (3) Streaming agent events and handling human-in-the-loop interactions, (4) Building chat UIs for coding agents, (5) Understanding the universal schema for agent responses."
 ---
 
 # Sandbox Agent
 
-Use this skill to deploy, configure, and integrate Sandbox Agent. Prefer citing canonical docs URLs from the reference map.
+Sandbox Agent provides a universal API for orchestrating AI coding agents in sandboxed environments.
 
 ## Quickstart