skill-name

description

Create a new AI agent skill following the Agent Skills specification

Create Skill Workflow

This workflow guides you through creating a new skill for the AI agent following the Agent Skills specification.

Prerequisites

Skills are stored in:

• Workspace-specific: <workspace-root>/.agent/skills/<skill-name>/
• Global: ~/.gemini/antigravity/skills/<skill-name>/

Steps

1. Understand the Skill Requirements

1. Ask the user what capability or expertise the skill should provide
2. Clarify the specific use cases and when the skill should be activated
3. Identify if the skill needs:
   • Scripts for executable code
   • References for documentation
   • Assets for templates or resources

2. Design the Skill

1. Choose a valid skill name (lowercase, hyphens only, 1-64 chars, no consecutive hyphens)
2. Write a clear description (1-1024 chars) that includes:
   • What the skill does
   • When to use it (keywords for agent discovery)
3. Outline the main instruction sections

3. Create Skill Directory Structure

.agent/skills/<skill-name>/
├── SKILL.md            # Required: instructions + metadata
├── scripts/            # Optional: executable helper scripts
├── references/         # Optional: detailed documentation
└── assets/             # Optional: templates, schemas, images

4. Write SKILL.md

Create the SKILL.md file with the following format:

---
name: skill-name
description: Clear description of what this skill does and when to use it. Include keywords for discovery.
---

# Skill Title

## When to Use This Skill

Describe the scenarios where this skill applies...

## Instructions



Detailed step-by-step instructions...



Continue with clear, actionable steps...



Provide input/output examples...



Document common edge cases and how to handle them...