From 6cc370c446f99b5c7e0dc90731df2857816bbf36 Mon Sep 17 00:00:00 2001 From: Mario Zechner Date: Sun, 25 Jan 2026 20:56:24 +0100 Subject: [PATCH] docs(coding-agent): clarify how to toggle settings and invoke templates - skills.md: mention /settings and settings.json for toggling skill commands - prompt-templates.md: add Usage section with examples --- packages/coding-agent/docs/prompt-templates.md | 12 +++++++++++- packages/coding-agent/docs/skills.md | 2 +- 2 files changed, 12 insertions(+), 2 deletions(-) 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: `. -Toggle skill commands in settings: +Toggle skill commands via `/settings` in interactive mode or in `settings.json`: ```json {