Fix docs-writer skill issues (#17734)

.gemini/skills/docs-writer/SKILL.md

@@ -1,4 +1,3 @@
-
 ---
 name: docs-writer
 description:

.gemini/skills/docs-writer/references/style-guide.md

@@ -33,7 +33,8 @@
   a natural tone.
 - **Simple vocabulary:** Use common words. Define technical terms when
   necessary.
-- **Conciseness:** Keep sentences short and focused.
+- **Conciseness:** Keep sentences short and focused, but don't omit
+  helpful information.
 - **"Please":** Avoid using the word "please."
 
 ## IV. Procedures and steps

GEMINI.md

@@ -72,7 +72,8 @@ powerful tool for developers.
 
 ## Documentation
 
+- Always use the `docs-writer` skill when you are asked to write, edit, or
+  review any documentation.
+- Documentation is located in the `docs/` directory.
 - Suggest documentation updates when code changes render existing documentation
   obsolete or incomplete.
-- Located in the `docs/` directory.
-- Use the `docs-writer` skill.

docs/cli/skills.md

@@ -91,8 +91,9 @@ gemini skills disable my-expertise --scope workspace
 
 ## Creating a Skill
 
-A skill is a directory containing a `SKILL.md` file at its root. This file uses
+A skill is a directory containing a `SKILL.md` file at its root. This file
-YAML frontmatter for metadata and Markdown for instructions.
+serves as the entry point for your skill and uses YAML frontmatter for metadata
+and Markdown for instructions.
 
 ### Folder Structure