Utilities
Diagnostic tools, updates, script execution, and skill management
doctor#
Diagnose installation and configuration issues.
Tip: Run skills doctor first if something isn't working. It checks paths, permissions, and configuration automatically.
skills doctor [options]
| Option | Description |
|---|---|
-f, --fix | Attempt to fix issues automatically |
-d, --deep | Run deep conflict detection across installed skills |
Output:
🔍 Diagnosing skills installation...
✓ Node.js: v25.2.1
✓ Git: available
✓ GitHub API: accessible
✓ Skills directory: /Users/you/.antigravity/skills
✓ Valid skills: 17/17
✓ No issues found
check#
Check installed skills and available updates.
skills check [options]
| Option | Description |
|---|---|
-a, --agent <agent> | Check specific agent only |
-g, --global | Check globally installed skills only |
--json | Output as JSON |
Examples:
skills check # Summary view
skills check --json # For scripting
skills check -a cursor # Cursor agent only
update#
Update installed skills from their sources.
skills update [skill-names...] [options]
| Option | Description |
|---|---|
-a, --all | Update all installed skills |
-g, --global | Only update globally installed skills |
-y, --yes | Skip confirmation prompts |
--prune | Remove skills whose source path no longer exists |
Examples:
skills update xlsx pdf # Update specific skills
skills update --all --yes # Update everything, no prompts
skills update --all --prune # Update and remove stale skills
skills update -g --prune # Prune only globally installed skills
Prune output:
✨ Updated 14 skill(s)
⚠ 2 skill(s) failed to update
🧹 Found 3 stale skill(s) (in lock but missing from disk):
- skill-creator (github)
- old-automation (github)
- removed-tool (gitlab)
✔ Removed skill-creator from lock file
✔ Removed old-automation from lock file
✔ Removed removed-tool from lock file
🧹 Pruned 3 stale skill(s) from lock file
Note: --prune scans all lock file entries and checks if their directories still exist on disk. Skills that were deleted or never properly installed (lock entry exists but no files on disk) are removed from the lock file. This is instant and works offline.
exec#
Execute a bundled script from a skill.
skills exec <skill-name> [script-name] [options]
| Option | Description |
|---|---|
-a, --args <args...> | Arguments to pass to the script |
Example:
skills exec xlsx generate-report --args data.csv
run#
Execute a script from an installed skill with timeout control.
skills run <skill-name> <script> [options]
| Option | Description |
|---|---|
-a, --args <args...> | Arguments to pass to the script |
--timeout <ms> | Timeout in milliseconds (default: 30000) |
Example:
skills run pdf extract --args document.pdf --timeout 60000
remove#
Remove installed skills.
skills remove [skills...] [options]
# Alias: skills rm
| Option | Description |
|---|---|
-g, --global | Remove from global installation |
-a, --agent <agent> | Remove from specific agent only |
-y, --yes | Skip confirmation prompt |
--all | Remove all installed skills |
Examples:
skills remove xlsx pdf --yes
skills rm --all --global
skills remove xlsx -a cursor
assets#
List and fetch assets for a skill on-demand from GitHub.
skills assets <skill-name> [options]
| Option | Description |
|---|---|
-l, --list | List available assets |
-m, --manifest | Show asset manifest if available |
-g, --get <path> | Fetch and display specific asset content |
--json | Output in JSON format |
Example:
skills assets xlsx --list
skills assets pdf --get templates/invoice.pdf