deploy-skills-in-antigravity

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: deploy-skills-in-antigravity
description: |
  Downloads, installs, and relocates new agent skills to the global Antigravity shared directory (`~/.gemini/config/skills/`) to make them available across all tools. Use when the user requests to download, install, import, setup, or update new agent skills, or asks to relocate installed skills.
metadata:
  author: Darren "Dazbo" Lester
  repository: https://github.com/derailed-dash/dazbo-agent-skills
  skills:
    - find-skills
  cli:
    - npx
---

# Deploying Skills in Antigravity

This skill provides a structured workflow for downloading, installing, and relocating new agent skills. It first checks for the availability of the `find-skills` skill to handle skill discovery, installation, or upgrades. If `find-skills` is unavailable, it falls back to direct CLI installation commands.

After installation or upgrade, if operating within an Antigravity environment (where `~/.gemini` exists), it prompts the user to confirm whether they want the skills relocated to `~/.gemini/config/skills/` so they become available across all Antigravity tools.

## Table of Contents

- [Triggers](#triggers)
- [Prerequisites](#prerequisites)
- [Installation and Relocation Workflow](#installation-and-relocation-workflow)
- [OS-Specific Relocation Commands](#os-specific-relocation-commands)
- [Verification Loop](#verification-loop)

## Triggers

This skill MUST trigger whenever:

- The user asks to download, install, import, setup, or update a new agent skill.
- The user mentions adding a skill from a repository or a specific branch/commit.
- The user or agent refers to CLI commands such as `npx skills add`, `skills add`, `skills install`, or `npx skills`.
- The user provides a repository URL (e.g. `https://github.com/...`) and asks to "add" or "integrate" its skills.

## Prerequisites

- **Node.js**: The system must have `npx` available to run the `skills` tool.
- **Access Permissions**: Ensure you have directory write permissions for `~/.agents/skills/` and, if relocating, `~/.gemini/config/skills/`.

## Installation and Relocation Workflow

Copy this checklist and track your progress:

```
Skill Deployment Progress:
- [ ] Step 1: Check for `find-skills` availability
- [ ] Step 2: Install or upgrade skills
- [ ] Step 3: Check for Antigravity environment and prompt user for relocation
- [ ] Step 4: Relocate skills (if confirmed)
- [ ] Step 5: Verify that files are correctly positioned
- [ ] Step 6: Sync & Register with `skills.json`
```

**Step 1: Check for `find-skills` availability**

Before initiating an installation or upgrade:
- Check if the `find-skills` skill is available in your active agent skills context.
- If `find-skills` is present, use it for discovering, installing, or upgrading skills in Step 2.
- If `find-skills` is NOT present, proceed to Step 2 using the direct CLI fallback commands detailed in this skill.

**Step 2: Install or upgrade skills**

Depending on `find-skills` availability:

- **When `find-skills` IS available:**
  - Delegate skill search, selection, installation, or updates to `find-skills`.
  - For new skill installation: execute `npx skills add <package> -g -y` (or specific repository URL/branch flags).
  - For skill upgrades: execute `npx skills update -g -y` (or `npx skills check`).
- **When `find-skills` is NOT available:**
  - Parse the user's request to identify the target repository URL, skill name, or branch.
  - Execute direct CLI commands using `run_command`:
    - Repository installation: `npx skills add https://github.com/username/repo-name -y -g`
    - Specific skill installation: `npx skills add https://github.com/username/repo-name -y -g --skill skill-name`
    - Skill upgrade: `npx skills update -g -y`

**Step 3: Check for Antigravity environment and prompt user for relocation**

> [!IMPORTANT] MANDATORY USER CONFIRMATION GATE
> You MUST STOP and ask the user using `ask_question` or a direct prompt before running any relocation script. Do NOT exec