diff --git a/creating-swift-skills/SKILL.md b/creating-swift-skills/SKILL.md
index 41fed93..cc81100 100644
--- a/creating-swift-skills/SKILL.md
+++ b/creating-swift-skills/SKILL.md
@@ -35,6 +35,8 @@ Avoid duplicating Apple docs without adding value.
 
 ```bash
 cp -r assets/templates/skill-template my-skill-name
+mv my-skill-name/SKILL.template.md my-skill-name/SKILL.md
+mv my-skill-name/references/example.template.md my-skill-name/references/topic.md
 ```
 
 ### 3. Write frontmatter
diff --git a/creating-swift-skills/assets/templates/skill-template/SKILL.template.md b/creating-swift-skills/assets/templates/skill-template/SKILL.template.md
new file mode 100644
index 0000000..ed64fcb
--- /dev/null
+++ b/creating-swift-skills/assets/templates/skill-template/SKILL.template.md
@@ -0,0 +1,28 @@
+---
+name: skill-name
+description: What it does + when to invoke it. Include trigger keywords.
+---
+
+# Skill Title
+
+## Overview
+
+One to two sentences describing purpose.
+
+## Workflow
+
+### 1. First step
+
+Actionable instruction.
+
+```swift
+// Code example
+```
+
+### 2. Next step
+
+More instructions with examples.
+
+## Reference material
+
+- See `references/topic.md` for detailed patterns.
diff --git a/creating-swift-skills/assets/templates/skill-template/references/example.template.md b/creating-swift-skills/assets/templates/skill-template/references/example.template.md
new file mode 100644
index 0000000..70006c0
--- /dev/null
+++ b/creating-swift-skills/assets/templates/skill-template/references/example.template.md
@@ -0,0 +1,20 @@
+# Topic name
+
+## Basic usage
+
+```swift
+// Minimal example showing the pattern
+```
+
+## Common patterns
+
+| Pattern | Use case |
+|---------|----------|
+| Pattern A | When X |
+| Pattern B | When Y |
+
+## Advanced
+
+```swift
+// More complex example
+```