Skill Porter for Google Antigravity
When to Use
Use when adapting a locally obtained Claude Code, Cursor, Codex, or generic agent
skill bundle for Google Antigravity. The utility preserves support files and
previews limited tool-name substitutions; it does not prove client compatibility.
Prerequisites
- Python 3.9+; standard library only.
- A reviewed local skill directory containing
SKILL.md, that file itself, or a
repository with skills/<lowercase-hyphenated-id>/SKILL.md directories.
- Verify the upstream identity, pinned revision, license and complete bundle first.
Obtain remote material separately through your reviewed download/clone workflow.
- Use stable local directories you control. Do not run against a tree being
modified by another process or user. Inspect scripts without executing them.
Workflow
From this skill directory, preview the local bundle:
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dry-run
Review the diff. Only exact backtick-quoted tool identifiers such as View,
Edit, and Bash change. Frontmatter and support bytes remain intact. Verify
each target tool and its argument semantics in your actual client.
Copy to a fresh staging destination, then inspect before activating:
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dest "/absolute/path/staging"
Existing skill destinations are rejected; no global paths are written.
When the user requests workspace installation, verify the current project:
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace --dry-run
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace
This writes only .agents/skills/<id> under the current working directory.
Confirm that discovery path is supported by the intended host first.
Review context-file references, tool argument shapes, client configuration,
dependencies, licensing and multi-agent ordering manually. Validate the adapted
skill and test actual client invocation before claiming compatibility.
Examples
For a multi-skill repository, use its local root as the source:
python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dry-run
python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dest "/absolute/path/fresh-output"
A source-only invocation defaults to preview. Remote URLs are rejected; obtain
and inspect a pinned local checkout first. Run bundled tests from this directory:
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest scripts/test_port_skill.py -v
Limitations
- Conservative text adaptation only: no AST conversion, semantic optimization,
automatic parallelization, artifact generation, or compatibility certification.
- Context references and support scripts retain their original bytes and may need
manual adaptation. Binary support files are copied intact, never interpreted.
- Symbolic links and non-regular files are rejected. Input is bounded to 1,000 files
and 20 MiB. This is not a sandbox against concurrent hostile filesystem changes;
use only stable directories you control.
- Disk or filesystem failure may leave a partial new destination. Inspect it and
choose a fresh output for retries. There is no overwrite or rollback mode.
- No downloads, credentials, network calls, global installation, plugin manifest
generation/registration or external MCP setup. Verify tool availability in the
actual host, whose version and capabilities may differ.
Source and license
Adapted from Pranav-Nexus/antigravity-skill-porter. The upstream MIT notice is
preserved in LICENSE.
1---
2name: skill-porter
3description: "Preview conservative tool-name translations and copy complete local skill bundles for manual adaptation to Google Antigravity."
4category: developer-tools
5risk: critical
6source: community
7source_repo: Pranav-Nexus/antigravity-skill-porter
8source_type: community
9date_added: "2026-09-07"
10author: Pranav-Nexus
11tags: [antigravity, claude, skills, migration, agent]
12tools: [claude, cursor, gemini]
13license: "MIT"
14license_source: "https://github.com/Pranav-Nexus/antigravity-skill-porter/blob/7a5b42c0fe1be283ae9f5b5fe70792aa78733af7/LICENSE"
15metadata:
16 source: https://skillmd.com/skills/sickn33/skill-porter
17---
18
19# Skill Porter for Google Antigravity
20
21## When to Use
22
23Use when adapting a locally obtained Claude Code, Cursor, Codex, or generic agent
24skill bundle for Google Antigravity. The utility preserves support files and
25previews limited tool-name substitutions; it does not prove client compatibility.
26
27## Prerequisites
28
29- Python 3.9+; standard library only.
30- A reviewed local skill directory containing `SKILL.md`, that file itself, or a
31 repository with `skills/<lowercase-hyphenated-id>/SKILL.md` directories.
32- Verify the upstream identity, pinned revision, license and complete bundle first.
33 Obtain remote material separately through your reviewed download/clone workflow.
34- Use stable local directories you control. Do not run against a tree being
35 modified by another process or user. Inspect scripts without executing them.
36
37## Workflow
38
391. From this skill directory, preview the local bundle:
40
41 ```bash
42 python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dry-run
43 ```
44
452. Review the diff. Only exact backtick-quoted tool identifiers such as `View`,
46 `Edit`, and `Bash` change. Frontmatter and support bytes remain intact. Verify
47 each target tool and its argument semantics in your actual client.
483. Copy to a fresh staging destination, then inspect before activating:
49
50 ```bash
51 python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dest "/absolute/path/staging"
52 ```
53
54 Existing skill destinations are rejected; no global paths are written.
554. When the user requests workspace installation, verify the current project:
56
57 ```bash
58 python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace --dry-run
59 python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace
60 ```
61
62 This writes only `.agents/skills/<id>` under the current working directory.
63 Confirm that discovery path is supported by the intended host first.
645. Review context-file references, tool argument shapes, client configuration,
65 dependencies, licensing and multi-agent ordering manually. Validate the adapted
66 skill and test actual client invocation before claiming compatibility.
67
68## Examples
69
70For a multi-skill repository, use its local root as the source:
71
72```bash
73python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dry-run
74python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dest "/absolute/path/fresh-output"
75```
76
77A source-only invocation defaults to preview. Remote URLs are rejected; obtain
78and inspect a pinned local checkout first. Run bundled tests from this directory:
79
80```bash
81PYTHONDONTWRITEBYTECODE=1 python3 -m unittest scripts/test_port_skill.py -v
82```
83
84## Limitations
85
86- Conservative text adaptation only: no AST conversion, semantic optimization,
87 automatic parallelization, artifact generation, or compatibility certification.
88- Context references and support scripts retain their original bytes and may need
89 manual adaptation. Binary support files are copied intact, never interpreted.
90- Symbolic links and non-regular files are rejected. Input is bounded to 1,000 files
91 and 20 MiB. This is not a sandbox against concurrent hostile filesystem changes;
92 use only stable directories you control.
93- Disk or filesystem failure may leave a partial new destination. Inspect it and
94 choose a fresh output for retries. There is no overwrite or rollback mode.
95- No downloads, credentials, network calls, global installation, plugin manifest
96 generation/registration or external MCP setup. Verify tool availability in the
97 actual host, whose version and capabilities may differ.
98
99## Source and license
100
101Adapted from Pranav-Nexus/antigravity-skill-porter. The upstream MIT notice is
102preserved in [LICENSE](LICENSE).