agy-cli-collab
Sticky Grok→Gemini collaboration via direct local Antigravity CLI (`agy`) subprocess calls only. Use when the user invokes /agy-cli-collab, $agy-cli-collab, says "antigravity collab", or asks Grok to consult Gemini through the agy CLI. Never use MCP agy_* tools when this skill is active. Multi-turn sessions resume with --conversation (pinned UUID) or --continue fallback.
- License 许可
- MIT
- 最近更新
- 2026-07-19
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- agy-cli-collab
- metadata
- { "short-description": "Grok→Gemini via agy CLI (no MCP)" }
- description
- Sticky Grok→Gemini collaboration via direct local Antigravity CLI (`agy`) subprocess calls only. Use when the user invokes /agy-cli-collab, $agy-cli-collab, says "antigravity collab", or asks Grok to consult Gemini through the agy CLI. Never use MCP agy_* tools when this skill is active. Multi-turn sessions resume with --conversation (pinned UUID) or --continue fallback.
02 资源文件 4
- 参考文档references/SMOKE_RESULTS.md2.4 KB
- 参考文档references/TEST_PLAN.md1.9 KB
- 脚本scripts/agy_cli.py5.1 KB
- 脚本scripts/run_smoke_tests.sh7.3 KB
03 SKILL.md 正文
Antigravity CLI Collab
Activate when the user invokes /agy-cli-collab, $agy-cli-collab, antigravity collab, or asks to consult Gemini through the local Antigravity CLI.
Invoking /agy-cli-collab enters Collab Mode for the rest of the session until the user says to leave it or the session ends. Proactively call agy when Gemini input would help — do not wait for the user to say "ask Gemini" each turn.
CLI-Only Rule
When this skill is active:
- Use direct
agysubprocess calls or the bundled helper script only. - Never call MCP tools
agy_ask,agy_ping,agy_models, oragy_version. - Do not silently fall back to MCP if a CLI call fails.
Contract
agy is the live collaboration channel to Gemini (Lead Scientist role per AGENTS.md).
Use agy for:
- PGS architecture and invariant synthesis
- Large-context file analysis
- Formalization and Lean strategy
- Experiment design feedback
- Strongest objection and falsification criteria
The repository remains the source of truth for durable artifacts, code, evidence, and documentation.
Serialize agy calls — never run parallel subprocesses.
Helper Script
Prefer the bundled helper for repeatable calls:
python /Users/velocityworks/.grok/skills/agy-cli-collab/scripts/agy_cli.py \
--cwd /Users/velocityworks/IdeaProjects/prime-gap-structure \
--mode start \
--new-project \
--log-file /tmp/agy-collab.log \
--state-file /tmp/agy-conv-id.txt \
--prompt-file /tmp/agy-task.md
Turn 2+ with pinned conversation:
python /Users/velocityworks/.grok/skills/agy-cli-collab/scripts/agy_cli.py \
--cwd /Users/velocityworks/IdeaProjects/prime-gap-structure \
--mode conversation \
--conversation "$(cat /tmp/agy-conv-id.txt)" \
--prompt-file /tmp/agy-task.md
Fallback when UUID is lost (same cwd only):
python ... --mode continue --prompt-file /tmp/agy-task.md
Command Modes
Always cd to a fixed repo root before every call. Session resume is keyed by shell cwd, not --add-dir.
Turn 1 — Start
cd /absolute/path/to/repo
agy --dangerously-skip-permissions \
--add-dir /absolute/path/to/repo \
--new-project \
--project agy-collab-<timestamp> \
--log-file /tmp/agy-collab.log \
--print-timeout 10m \
-p "$(cat /tmp/agy-task.md)"
Capture conversation UUID from log line Created conversation <uuid> into a state file.
Turn 2+ — Pinned Resume (preferred)
cd /absolute/path/to/repo
agy --dangerously-skip-permissions \
--add-dir /absolute/path/to/repo \
--conversation <pinned-uuid> \
--print-timeout 10m \
-p "$(cat /tmp/agy-task.md)"
Turn 2+ — Continue Fallback
agy --dangerously-skip-permissions --add-dir <repo> --continue -p "..." --print-timeout 10m
One-Shot — Clean
agy --dangerously-skip-permissions --add-dir <repo> -p "..." --print-timeout 10m
No --continue or --conversation.
Prompt Style
Write focused task briefs for Gemini (Lead Scientist).
Include:
- collaboration role and PGS-native frame first
- whether Gemini may edit files (default: read-only)
- exact repository paths
- current evidence or measured result summaries
- the precise question or design request
- required output shape
Do not send Grok's hidden reasoning. Send evidence and the question.
Default to non-mutating prompts unless the user explicitly authorizes file edits. State exact write scope when edits are allowed.
Output Handling
After agy returns:
- summarize the useful contribution
- preserve material disagreement
- continue work without asking the user to mediate
- cite repo paths when Gemini's answer changes the work
- optionally include a compact Gemini contribution section
- integrate into one answer — do not paste Gemini's output as the final response
- do not pretend Gemini participated if the CLI call failed
Hazards
--dangerously-skip-permissionsauto-approves tool execution — scope prompts carefully- Invalid
--conversationUUID may silently start a new thread — always capture UUID from turn-1 log agy versionfails in non-TTY — use print-mode smoke for health checks- Print mode model follows CLI settings; explicit
--modelmay not apply in-pmode - Long tasks need adequate
--print-timeout(default 10m in helper)
Failure Rule
If the agy CLI call fails:
- report the exact command shape and error
- do not fall back to MCP
- do not pretend Gemini participated
- continue locally only if the user explicitly asked to proceed without Gemini
Known Good Validation
Validated on prime-gap-structure:
agy at ~/.local/bin/agy (1.0.16)
--dangerously-skip-permissions + -p works headless
--continue preserves session per cwd
--conversation <uuid> pins exact thread
helper returns AGY_HELPER_NORMAL_OK, AGY_HELPER_CONV_OK, AGY_HELPER_CONTINUE_OK
04 同仓库更多 Skills
Zotero
Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.
zoom-apps-sdk
Use when using Apps SDK.
youtube
Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".
yeet
Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.
x-post-creator
Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.
x-api
Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".