docs(api): write a skill that shares a command's name as /skill:<name>

docs/api.html

@@ -149,6 +149,7 @@ <h3 id="while-answering">A message sent while Clark is answering</h3>
 
 <h2 id="references">Point at a skill, a project or a file</h2>
 <p>A message can carry up to 8 typed references beside its text: a skill, a project, a file or folder inside an indexed project, an MCP service, another conversation or a piece of background work. Ask <code>GET /composer/suggestions</code> for them rather than building them by hand, and send the <code>ref</code> of each row you choose. The app's inbox sends one more kind the same way, a notice, when you use Ask Clark or Add to context on it.</p>
+<p>A message that starts with a slash command, such as <code>/new</code>, is answered as that command. So write a skill in the text as <code>/&lt;name&gt;</code>, or as <code>/skill:&lt;name&gt;</code> when its name is also a command's: a skill called <code>new</code> goes as <code>/skill:new</code> and is invoked, while <code>/new</code> starts a new conversation. Typing <code>skill:</code> after the slash (<code>trigger=/&amp;q=skill:ne</code>) lists only skills.</p>
 <div class="code" data-code>
 <button class="code__copy" type="button" data-copy data-copied-label="Copied" data-failed-label="Select and copy">Copy</button>
 <pre><code>curl -s "$CLARKCANT_URL/composer/suggestions?trigger=@&amp;q=myapp/src/" \

docs/index.html

@@ -98,6 +98,7 @@ <h2 id="slash-commands">Slash commands</h2>
   <li><code>/background &lt;request&gt;</code> runs the request as background work beside the conversation and reports back in it.</li>
   <li><code>/report</code> reports a bug or asks for a feature in ClarkCant itself. See <a href="#report">below</a>.</li>
 </ul>
+<p>A skill whose name is also a command's is listed and written as <code>/skill:&lt;name&gt;</code>, so choosing it uses the skill; typing <code>/new</code> yourself still runs the command.</p>
 <p>A command typed in the middle of a sentence is just text. Commands are not sent to the model. See <a href="api.html#provider-sign-in">provider sign-in routes</a>.</p>
 
 <h2 id="report">Report a bug or request a feature</h2>

vi/docs/api.html

@@ -149,6 +149,7 @@ <h3 id="while-answering">Tin nhắn gửi khi Clark đang trả lời</h3>
 
 <h2 id="references">Chỉ tới một kỹ năng, một dự án hay một tệp</h2>
 <p>Ngoài phần chữ, một tin nhắn có thể mang tối đa 8 tham chiếu có kiểu: một kỹ năng, một dự án, một tệp hay thư mục trong dự án đã được lập chỉ mục, một dịch vụ MCP, một cuộc trò chuyện khác hoặc một việc nền. Hãy lấy chúng từ <code>GET /composer/suggestions</code> thay vì tự dựng, rồi gửi <code>ref</code> của từng dòng bạn chọn. Hộp thư của ứng dụng cũng gửi theo cách đó một loại nữa, là thông báo, khi bạn dùng Hỏi Clark hoặc Thêm vào ngữ cảnh trên nó.</p>
+<p>Tin nhắn bắt đầu bằng một lệnh gạch chéo, như <code>/new</code>, được trả lời như lệnh đó. Vì vậy hãy viết kỹ năng trong phần chữ thành <code>/&lt;tên&gt;</code>, hoặc thành <code>/skill:&lt;tên&gt;</code> khi tên của nó trùng với một lệnh: kỹ năng tên <code>new</code> được gửi thành <code>/skill:new</code> và được gọi, còn <code>/new</code> thì mở một cuộc trò chuyện mới. Gõ <code>skill:</code> sau dấu gạch chéo (<code>trigger=/&amp;q=skill:ne</code>) thì chỉ liệt kê kỹ năng.</p>
 <div class="code" data-code>
 <button class="code__copy" type="button" data-copy data-copied-label="Đã chép" data-failed-label="Hãy chọn và chép">Sao chép</button>
 <pre><code>curl -s "$CLARKCANT_URL/composer/suggestions?trigger=@&amp;q=myapp/src/" \

vi/docs/index.html

@@ -99,6 +99,7 @@ <h2 id="slash-commands">Lệnh gạch chéo</h2>
   <li><code>/background &lt;yêu cầu&gt;</code> chạy yêu cầu thành việc nền bên cạnh cuộc trò chuyện và báo kết quả trong đó.</li>
   <li><code>/report</code> báo lỗi hoặc đề xuất tính năng cho chính ClarkCant. Xem <a href="#report">bên dưới</a>.</li>
 </ul>
+<p>Skill trùng tên với một lệnh được liệt kê và ghi thành <code>/skill:&lt;tên&gt;</code>, nên chọn nó là dùng skill đó; tự gõ <code>/new</code> thì vẫn chạy lệnh.</p>
 <p>Lệnh gõ ở giữa câu chỉ là chữ thường. Lệnh không được gửi tới model. Xem <a href="api.html#provider-sign-in">các route đăng nhập provider</a>.</p>
 
 <h2 id="report">Báo lỗi hoặc đề xuất tính năng</h2>