gemini-command-development

使用 markdownlint-cli2 进行全面的 markdown 检查指导。运行、执行、检查和验证 markdown 文件。修复检查错误(MD0XX 规则)。配置 .markdownlint-cli2.jsonc(规则和忽略)。设置 VS Code 扩展和 GitHub Actions 工作流。在使用 markdown 文件、遇到验证错误、配置 markdownlint、设置检查工作流、排查检查问题或建立 markdown 质量标准时使用。

📖 中文导读:使用 markdownlint-cli2 进行全面的 markdown 检查指导。运行、执行、检查和验证 markdown 文件。修复检查错误(MD0XX 规则)。配置 .markdownlint-cli2.jsonc(规则和忽略)。设置 VS Code 扩展和 GitHub Actions 工作流。在使用 markdown 文件、遇到验证错误、配置 markdownlint、设置检查工作流、排查检查问题或建立 markdown 质量标准时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: gemini-command-development description: Expert guide for creating custom Gemini CLI commands. Covers slash command definitions (.toml), argument parsing, and shell execution. Use when creating custom Gemini commands, defining TOML command files, adding command arguments, or building extension-based commands. Delegates to gemini-cli-docs. allowed-tools: Read, Glob, Grep, Skill

Gemini Command Development

🚨 MANDATORY: Invoke gemini-cli-docs First

STOP - Before providing ANY response about Gemini Commands:

  1. INVOKE gemini-cli-docs skill
  2. QUERY for the specific command topic
  3. BASE all responses EXCLUSIVELY on official documentation loaded

Overview

Expert skill for defining custom slash commands in the Gemini CLI. Unlike Claude Code's markdown-based commands, Gemini uses TOML configuration or Extension-based commands.

When to Use This Skill

Keywords: gemini commands, custom slash commands, .toml commands, command arguments, command alias

Use this skill when:

  • Creating custom commands in commands.toml (or similar)
  • creating extension-based commands (<extension>/commands/*.toml)
  • Defining command arguments and defaults
  • Mapping commands to complex prompts

Command Structure (TOML)

Gemini commands are typically defined in TOML files within extensions or configuration.

[command-name]
description = "Description"
prompt = "The actual prompt to send..."

(Note: Verify exact syntax via gemini-cli-docs as specific implementation details vary by version)

Keyword Registry (Delegates to gemini-cli-docs)

Topic Query Keywords
Definition custom commands toml, define slash command
Arguments command arguments, command variables
Scope workspace commands, global commands

Quick Decision Tree

What do you want to do?

  1. Create a Simple Alias -> Query gemini-cli-docs: "create custom command"
  2. Package Command in Extension -> Query gemini-cli-docs: "extension commands structure"

Test Scenarios

Scenario 1: Create Custom Command

Query: "How do I create a custom slash command in Gemini CLI?" Expected Behavior:

  • Skill activates on "custom slash commands"
  • Delegates to gemini-cli-docs for TOML syntax Success Criteria: User receives TOML command definition example

Scenario 2: Extension Commands

Query: "How do I add commands to my Gemini extension?" Expected Behavior:

  • Skill activates on "extension commands"
  • Provides extension command structure Success Criteria: User receives extension commands path and format

Scenario 3: Command Arguments

Query: "How do I pass arguments to a Gemini command?" Expected Behavior:

  • Skill activates on "command arguments"
  • Delegates to docs for variable syntax Success Criteria: User receives argument handling pattern

References

Official Documentation: Query gemini-cli-docs for:

  • "custom commands"
  • "slash commands"

Version History

  • v1.1.0 (2025-12-01): Added Test Scenarios section
  • v1.0.0 (2025-11-25): Initial release