diff --git a/.claude/skills/docs-sandpack/SKILL.md b/.claude/skills/docs-sandpack/SKILL.md
index 0904a98c096..fb2ebb5a0e2 100644
--- a/.claude/skills/docs-sandpack/SKILL.md
+++ b/.claude/skills/docs-sandpack/SKILL.md
@@ -1,8 +1,10 @@
 ---
 name: docs-sandpack
-description: Use when adding interactive code examples to React docs.
+description:  Use when adding interactive Sandpack code examples, live React playgrounds, or multi-file code demos to React documentation.
 ---
 
+This skill provides patterns and conventions for creating Sandpack examples in React documentation, including multi-file demos, line highlights, hidden files, and dependency configuration.
+
 # Sandpack Patterns
 
 ## Quick Start Template