From bd156e6832d98977e9bdbf0b0d888cc2747b54ff Mon Sep 17 00:00:00 2001 From: g-samroberts <158088236+g-samroberts@users.noreply.github.com> Date: Wed, 4 Feb 2026 09:52:30 -0800 Subject: [PATCH] Add information about the agent skills lifecycle and clarify docs-writer skill metadata. (#18234) Co-authored-by: Jenna Inouye --- .gemini/skills/docs-writer/SKILL.md | 3 +-- docs/cli/skills.md | 9 ++++++++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/.gemini/skills/docs-writer/SKILL.md b/.gemini/skills/docs-writer/SKILL.md index 319ddda598..13fc91765e 100644 --- a/.gemini/skills/docs-writer/SKILL.md +++ b/.gemini/skills/docs-writer/SKILL.md @@ -2,8 +2,7 @@ name: docs-writer description: Always use this skill when the task involves writing, reviewing, or editing - documentation, specifically for any files in the `/docs` directory or any - `.md` files in the repository. + files in the `/docs` directory or any `.md` files in the repository. --- # `docs-writer` skill instructions diff --git a/docs/cli/skills.md b/docs/cli/skills.md index 297bd80ed4..34331a4c0c 100644 --- a/docs/cli/skills.md +++ b/docs/cli/skills.md @@ -89,7 +89,7 @@ gemini skills enable my-expertise gemini skills disable my-expertise --scope workspace ``` -## How it Works (Security & Privacy) +## How it Works 1. **Discovery**: At the start of a session, Gemini CLI scans the discovery tiers and injects the name and description of all enabled skills into the @@ -106,6 +106,13 @@ gemini skills disable my-expertise --scope workspace 5. **Execution**: The model proceeds with the specialized expertise active. It is instructed to prioritize the skill's procedural guidance within reason. +### Skill activation + +Once a skill is activated (typically by Gemini identifying a task that matches +the skill's description and your approval), its specialized instructions and +resources are loaded into the agent's context. A skill remains active and its +guidance is prioritized for the duration of the session. + ## Creating your own skills To create your own skills, see the [Create Agent Skills](./creating-skills.md)