From 3ddb0cb1d368f1e39240a8543d7e0478a5980e2d Mon Sep 17 00:00:00 2001 From: Filip <34747899+neriousy@users.noreply.github.com> Date: Fri, 2 Oct 2026 15:09:38 +0200 Subject: [PATCH] docs: remove skill slash frontmatter from v2 docs (#52752) --- services/www/src/docs/content/skills.mdx | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/services/www/src/docs/content/skills.mdx b/services/www/src/docs/content/skills.mdx index 56fec46c624..2301c68629c 100644 --- a/services/www/src/docs/content/skills.mdx +++ b/services/www/src/docs/content/skills.mdx @@ -120,7 +120,6 @@ Use frontmatter to name the skill and control where it appears: --- name: Git Release description: Prepare a repository release -slash: true metadata: opencode/autoinvoke: false --- @@ -128,14 +127,12 @@ metadata: Prepare the changelog, version bump, tag, and release notes. ``` -| Field | Behavior | -| ------------------------------ | ------------------------------------------------------------------ | -| `name` | Display name; defaults to the path-derived ID | -| `description` | Summary used to show the skill to the model | -| `slash` | Set to `false` to hide the skill from interactive command catalogs | -| `metadata.opencode/slash` | Boolean or `"true"`/`"false"`; overrides `slash` | -| `metadata.opencode/autoinvoke` | Set to `false` to omit the skill from the model's available list | -| `disable-model-invocation` | Set to `true` for the same effect as `opencode/autoinvoke: false` | +| Field | Behavior | +| ------------------------------ | ----------------------------------------------------------------- | +| `name` | Display name; defaults to the path-derived ID | +| `description` | Summary used to show the skill to the model | +| `metadata.opencode/autoinvoke` | Set to `false` to omit the skill from the model's available list | +| `disable-model-invocation` | Set to `true` for the same effect as `opencode/autoinvoke: false` | All frontmatter is optional at runtime. Add a clear `description` when the model should discover the skill; skills without one are not advertised. @@ -198,6 +195,8 @@ OpenCode then: 3. Adds the Markdown body, without frontmatter, to the conversation. 4. Provides the skill's base directory and a sample of up to ten supporting file paths. +To load a skill yourself, mention it in your prompt as `@skill-id`. + Supporting file contents are not loaded automatically. The agent reads them when the skill directs it to do so. The file sample is available for directory-based `SKILL.md` skills; flat Markdown skills do not receive a neighboring file list. ## Permissions