Answer: To write a good description for a Gemini CLI Agent Skill, be specific with keywords likely to appear in user prompts, define the trigger by clearly stating when the skill should be used, and avoid overlap with other skills and the model's general capabilities. Status: Confirmed Entry: tool/gemini-cli/agents-and-automation/write-skill-description Revision: 1 Digest: sha256:5397ae98cd312bcf (changes whenever the content changes) Timeline: Created: 2026-11-13T03:17:45Z Last changed: 2026-11-13T03:17:45Z Last verified: 2026-11-20T12:51:26Z Next check: 2026-11-21T12:51:26Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of specificity guidance | Be specific | [1] | 2026-11-20 trigger guidance | Define the trigger | [1] | 2026-11-20 overlap guidance | Avoid overlap | [1] | 2026-11-20 importance of description | The most important part of a skill is its `description`. | [1] | 2026-11-20 Sources: [1] Google. "Agent Skill best practices". https://geminicli.com/docs/cli/skills-best-practices.md Role: primary. Accessed: 2026-11-20T12:51:26Z Quote: "**Be specific**: Use keywords that are likely to appear in user prompts" (Supports: specificity guidance) Quote: "**Define the trigger**: Clearly state _when_ the skill should be used" (Supports: trigger guidance) Quote: "**Avoid overlap**: Ensure your skill descriptions are distinct from one" (Supports: overlap guidance) Quote: "The most important part of a skill is its `description`." (Supports: importance of description) Published: 2026-10-16T02:36:07Z Snapshot SHA-256: 612c3b8396fdc6669702127975c5d4ec5ce59bd8355fdbfb837fdd83d3d524c3 (captured 2026-11-13T03:17:45Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:17:45Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:51:26Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:51:26Z Last attempt: 2026-11-20T12:51:26Z Notes and limitations: Extracted automatically from a single official source (section "Design for discovery"). Related: https://latestn.com/tool/gemini-cli/commands-and-shortcuts/add-custom-command How do I add a custom command to a Gemini CLI extension? https://latestn.com/tool/gemini-cli/commands-and-shortcuts/browse-past-sessions How do I browse and load past Gemini CLI sessions? https://latestn.com/tool/gemini-cli/commands-and-shortcuts/cli-options What CLI options are available in Gemini CLI? https://latestn.com/tool/gemini-cli/agents-and-automation/trusted-folders-headless How does Gemini CLI handle trusted folders in headless or automated environments? https://latestn.com/tool/gemini-cli/agents-and-automation/unassign-inactive-assignees How does Gemini CLI automatically unassign inactive issue assignees? https://latestn.com/tool/gemini-cli/agents-and-automation/use-agent-skill-in-session How do I activate or use an Agent Skill during a Gemini CLI session? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:17:45Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/gemini-cli/agents-and-automation/write-skill-description/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/gemini-cli/agents-and-automation/write-skill-description POST: https://latestn.com/dispute/tool/gemini-cli/agents-and-automation/write-skill-description with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/gemini-cli/agents-and-automation/write-skill-description?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I write a good description for a Gemini CLI Agent Skill? Revision 1, last verified 2026-11-20T12:51:26Z. https://latestn.com/tool/gemini-cli/agents-and-automation/write-skill-description (accessed 2026-11-21T09:57:05Z). @misc{LatestN_tool_gemini_cli_agents_and_automation_write_skill_description_r1, title = {How do I write a good description for a Gemini CLI Agent Skill?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/gemini-cli/agents-and-automation/write-skill-description}}, note = {Revision 1; digest sha256:5397ae98cd312bcf; last verified 2026-11-20T12:51:26Z; accessed 2026-11-21T09:57:05Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/gemini-cli/agents-and-automation/write-skill-description