diff --git a/plugins/obsidian-cli/skills/obsidian-cli/SKILL.md b/plugins/obsidian-cli/skills/obsidian-cli/SKILL.md
index 0d618da..0188557 100644
--- a/plugins/obsidian-cli/skills/obsidian-cli/SKILL.md
+++ b/plugins/obsidian-cli/skills/obsidian-cli/SKILL.md
@@ -210,6 +210,7 @@ obsidian sync:restore path="important.md" version=3  # Rollback
 6. **Stderr noise** — GPU/Electron warnings on headless are harmless; filter with `2>/dev/null`.
 7. **`daily:prepend`** inserts content after frontmatter, not at byte 0.
 8. **Use `eval`** to run arbitrary JavaScript against the Obsidian API (`app.*`).
+9. **`template:insert`** inserts into the currently active file in the Obsidian UI — it does not accept a `path=` parameter. To create a file from a template via CLI, use `obsidian create path="..." template="..."` instead.
 
 ## Troubleshooting
 
diff --git a/skills/obsidian-cli/SKILL.md b/skills/obsidian-cli/SKILL.md
index 0d618da..0188557 100644
--- a/skills/obsidian-cli/SKILL.md
+++ b/skills/obsidian-cli/SKILL.md
@@ -210,6 +210,7 @@ obsidian sync:restore path="important.md" version=3  # Rollback
 6. **Stderr noise** — GPU/Electron warnings on headless are harmless; filter with `2>/dev/null`.
 7. **`daily:prepend`** inserts content after frontmatter, not at byte 0.
 8. **Use `eval`** to run arbitrary JavaScript against the Obsidian API (`app.*`).
+9. **`template:insert`** inserts into the currently active file in the Obsidian UI — it does not accept a `path=` parameter. To create a file from a template via CLI, use `obsidian create path="..." template="..."` instead.
 
 ## Troubleshooting