🔧 chore: add nested path validation to skill-creator

- Added path validation to prevent .vibe/.vibe nested directory creation
- Enhanced BEST_PRACTICES.md with path handling patterns
- Added troubleshooting section to ADVANCED_FEATURES.md
- Shows actual creation path for transparency

Fixes: Issue with skills being created in incorrect nested paths
Refs: #skill-creation, #path-validation

.vibe/skills/skill-creator/references/ADVANCED_FEATURES.md

@@ -1,5 +1,37 @@
 # Advanced Skill Creator Features
 
+## Known Issues and Troubleshooting
+
+### Nested Path Creation Issue
+
+**Symptom**: Skills created in incorrect nested paths like `.vibe/skills/.vibe/skills/skill-name`
+
+**Cause**: Running `create_skill.sh` from within the `.vibe/skills/` directory causes relative path resolution issues.
+
+**Solution**: 
+1. Always run the script from project root
+2. Use absolute paths when necessary
+3. The script now includes validation to detect and prevent this issue
+
+**Prevention**: Added path validation in `create_skill.sh`:
+```bash
+# Validate path - ensure we're not creating nested .vibe directories
+if [[ "$SKILL_DIR" == *".vibe/.vibe"* ]]; then
+    echo "❌ Error: Detected nested .vibe path: $SKILL_DIR"
+    exit 1
+fi
+```
+
+### Workaround
+If you encounter this issue:
+```bash
+# Move the skill to correct location
+mv .vibe/skills/.vibe/skills/your-skill .vibe/skills/your-skill
+
+# Update any internal path references
+find .vibe/skills/your-skill -type f -exec sed -i '' 's|.vibe/skills/.vibe/skills|.vibe/skills|g' {} +
+```
+
 ## Skill Versioning and Updates
 
 ### Version Management