agy ask
The quick mode: one question in, one answer out, ~3 seconds on the default gemini-3.8-flash-low. Zero tools by design (restricted profile, question-only prompt), so it needs no setup and works on a fresh install — run it first as the smoke test: ask --prompt "reply with OK".
ask is the only persona that runs in the foreground: the call blocks, records an ask-... job ID (emitted on stderr as job=ask-... and listed by status), and returns the answer on stdout. staffer, researcher, reviewer, and implementer instead return a background job id (see the jobs skill, ../jobs/SKILL.md).
Dispatch
- Continue a completed job with
continue --job <id> --prompt "..." when the task and persona are the same and prior context helps, even if the user does not say "continue". Keep each job ID with its assignment; if the target is unclear, check known jobs before asking the user.
- Start fresh for a different task or persona, an independent opinion, or an explicit fresh start. Carry relevant findings and artifact paths into the new brief.
- Pass the user's task and explicit authorizations verbatim. On follow-up, add decisions and constraints from the host chat that the worker has not seen. Continuation does not expand authorization.
- Run the companion unsandboxed; in Codex, request escalated execution. Follow
../jobs/SKILL.md for collection and recovery. After an execution timeout, obtain explicit user confirmation before continuing or restarting.
Locating the companion
This skill file lives at <plugin-root>/skills/ask/SKILL.md; resolve the companion path relative to this skill directory:
node "<skill-dir>/../../companion/agy-companion.mjs" ask [flags] --prompt "question"
Flags (all optional)
--prompt <text> / --prompt-file <path> / --stdin — the question, from exactly one of these three sources. Use file/stdin for a long question.
--model <id> or --effort low|medium|high — default model is gemini-3.8-flash-low; --model also accepts family aliases carbon (gemini-4-carbon), argon (gemini-4-argon), flash (gemini-3.8-flash), and pro (gemini-3.1-pro).
--timeout <dur> — default 2m.
For a follow-up to an earlier ask run, use continue --job <id> --prompt "question" with the ask-... job ID recorded on stderr (or listed by status). A continued ask job stays synchronous in the foreground.
ask is always restricted (it is tool-free, so there is nothing to unrestrict); --unrestricted is ignored with a note on stderr. That is fixed for ask alone — the tool-using personas default to unrestricted, where --restricted is an opt-in hardening flag. Execution style is likewise fixed per mode and no flag changes it.
Rules
- Pass the user's question through verbatim and return the answer verbatim. The
[agy-staff] telemetry line arrives on stderr and is metadata for you, the calling agent — do not show it to the user; mention the follow-up ability in natural language when relevant, and give model/duration/token numbers only if asked.
- If the answer says "not sure", relay it as-is; do not silently substitute your own answer.
- Exit 5 means a resumable response timeout: explain it and ask whether the user wants to continue with the suggested timeout or stop. Continue only after explicit user confirmation, using
continue --job <id> --timeout <dur> with the recorded ask-... job ID. For other companion errors, quote the error and add a concise diagnosis. Full failure protocol: ../jobs/SKILL.md.
1---2name: ask3description: Ask Google's Antigravity CLI (agy staffer, fast Gemini) a cheap one-shot question - the fast zero-tool mode and the post-install smoke test. Use when the user says /agy:ask, "ask agy", "quick second opinion from agy", or right after installing to verify the plugin works.4argument-hint: '[--model <id>|--effort low|medium|high] [--timeout <dur>] "question"'5allowed-tools: Bash(node:*)6metadata:7 source: https://skillmd.com/skills/keli-wen/ask8---910# agy ask1112The quick mode: one question in, one answer out, ~3 seconds on the default `gemini-3.8-flash-low`. Zero tools by design (restricted profile, question-only prompt), so it needs no setup and works on a fresh install — run it first as the smoke test: `ask --prompt "reply with OK"`.1314ask is the only persona that runs in the foreground: the call blocks, records an `ask-...` job ID (emitted on stderr as `job=ask-...` and listed by `status`), and returns the answer on stdout. staffer, researcher, reviewer, and implementer instead return a background job id (see the jobs skill, `../jobs/SKILL.md`).1516<!-- BEGIN SHARED PERSONA RULES -->17<!-- Generated from templates/persona-skill-rules.md; run npm run generate:skills. Do not edit this block. -->18## Dispatch1920- Continue a completed job with `continue --job <id> --prompt "..."` when the task and persona are the same and prior context helps, even if the user does not say "continue". Keep each job ID with its assignment; if the target is unclear, check known jobs before asking the user.21- Start fresh for a different task or persona, an independent opinion, or an explicit fresh start. Carry relevant findings and artifact paths into the new brief.22- Pass the user's task and explicit authorizations verbatim. On follow-up, add decisions and constraints from the host chat that the worker has not seen. Continuation does not expand authorization.23- Run the companion unsandboxed; in Codex, request escalated execution. Follow `../jobs/SKILL.md` for collection and recovery. After an execution timeout, obtain explicit user confirmation before continuing or restarting.24<!-- END SHARED PERSONA RULES -->2526## Locating the companion2728This skill file lives at `<plugin-root>/skills/ask/SKILL.md`; resolve the companion path relative to this skill directory:2930```bash31node "<skill-dir>/../../companion/agy-companion.mjs" ask [flags] --prompt "question"32```3334## Flags (all optional)3536- `--prompt <text>` / `--prompt-file <path>` / `--stdin` — the question, from exactly one of these three sources. Use file/stdin for a long question.37- `--model <id>` or `--effort low|medium|high` — default model is `gemini-3.8-flash-low`; `--model` also accepts family aliases `carbon` (`gemini-4-carbon`), `argon` (`gemini-4-argon`), `flash` (`gemini-3.8-flash`), and `pro` (`gemini-3.1-pro`).38- `--timeout <dur>` — default 2m.3940For a follow-up to an earlier `ask` run, use `continue --job <id> --prompt "question"` with the `ask-...` job ID recorded on stderr (or listed by `status`). A continued `ask` job stays synchronous in the foreground.4142ask is always restricted (it is tool-free, so there is nothing to unrestrict); `--unrestricted` is ignored with a note on stderr. That is fixed for ask alone — the tool-using personas default to unrestricted, where `--restricted` is an opt-in hardening flag. Execution style is likewise fixed per mode and no flag changes it.4344## Rules4546- Pass the user's question through verbatim and return the answer verbatim. The `[agy-staff]` telemetry line arrives on stderr and is metadata for you, the calling agent — do not show it to the user; mention the follow-up ability in natural language when relevant, and give model/duration/token numbers only if asked.47- If the answer says "not sure", relay it as-is; do not silently substitute your own answer.48- Exit 5 means a resumable response timeout: explain it and ask whether the user wants to continue with the suggested timeout or stop. Continue only after explicit user confirmation, using `continue --job <id> --timeout <dur>` with the recorded `ask-...` job ID. For other companion errors, quote the error and add a concise diagnosis. Full failure protocol: `../jobs/SKILL.md`.