diff --git a/packages/coding-agent/docs/prompt-templates.md b/packages/coding-agent/docs/prompt-templates.md
index e1b65819..d6e540bb 100644
--- a/packages/coding-agent/docs/prompt-templates.md
+++ b/packages/coding-agent/docs/prompt-templates.md
@@ -2,7 +2,7 @@
 
 # Prompt Templates
 
-Prompt templates are Markdown snippets that expand into full prompts when you type `/name` in the editor.
+Prompt templates are Markdown snippets that expand into full prompts. Type `/name` in the editor to invoke a template, where `name` is the filename without `.md`.
 
 ## Locations
 
@@ -31,6 +31,16 @@ Review the staged changes (`git diff --cached`). Focus on:
 - The filename becomes the command name. `review.md` becomes `/review`.
 - `description` is optional. If missing, the first non-empty line is used.
 
+## Usage
+
+Type `/` followed by the template name in the editor. Autocomplete shows available templates with descriptions.
+
+```
+/review                           # Expands review.md
+/component Button                 # Expands with argument
+/component Button "click handler" # Multiple arguments
+```
+
 ## Arguments
 
 Templates support positional arguments and simple slicing:
diff --git a/packages/coding-agent/docs/skills.md b/packages/coding-agent/docs/skills.md
index 9e1bcc0c..239bdb6a 100644
--- a/packages/coding-agent/docs/skills.md
+++ b/packages/coding-agent/docs/skills.md
@@ -74,7 +74,7 @@ Skills register as `/skill:name` commands:
 
 Arguments after the command are appended to the skill content as `User: <args>`.
 
-Toggle skill commands in settings:
+Toggle skill commands via `/settings` in interactive mode or in `settings.json`:
 
 ```json
 {