AGENT SKILL

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

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 agy subprocess calls or the bundled helper script only.
  • Never call MCP tools agy_ask, agy_ping, agy_models, or agy_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-permissions auto-approves tool execution — scope prompts carefully
  • Invalid --conversation UUID may silently start a new thread — always capture UUID from turn-1 log
  • agy version fails in non-TTY — use print-mode smoke for health checks
  • Print mode model follows CLI settings; explicit --model may not apply in -p mode
  • 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

zfifteen
zfifteen/skills-catalog

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.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

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".

★ 1
zfifteen
zfifteen/skills-catalog

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.

★ 1
zfifteen
zfifteen/skills-catalog

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]/.

★ 1
zfifteen
zfifteen/skills-catalog

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".

★ 1