New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Researcher

by keli-wen in keli-wen/agy-staff

Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini).

MITAuto-check passedResearch & Science

Install Researcher

skills CLI
$ npx skills add keli-wen/agy-staff --skill researcher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install keli-wen/agy-staff researcher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/keli-wen/agy-staff.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/researcher .claude/skills/researcher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
researcher
GitHub stars
733
Token cost
~966 tokens
SKILL.md length
438 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini).

  • The user says /agy:researcher
  • SKILL.md covers Locating the companion, Collecting the result, Flags (all optional) and Rules
  • Calls node
  • Ask agy to research

What it does

Researcher is an agent skill from keli-wen/agy-staff. Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini). Use when the user says /agy:researcher, "ask agy to research", "have the agy staffer survey X", or wants a second, independent deep-dive on a topic or codebase without spending the host model's quota.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Deep research. The repository describes itself as: Hire Google's Antigravity CLI (agy) as a fast Gemini staffer for Claude Code and OpenAI Codex. The licence is MIT.

When your agent uses it

  • The user says /agy:researcher
  • Ask agy to research
  • Have the agy staffer survey X
  • Independent deep-dive on a topic

Example prompts

  • “ask agy to research”
  • “have the agy staffer survey X”
  • “/researcher”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash(node:*), Bash(git:*), Bash(gh:*)

What it can do on your machine

Read from SKILL.md and the folder at commit 65a1ab4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Bash(node:*)
    • Bash(git:*)
    • Bash(gh:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Researcher loads about 966 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 438 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~966

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from keli-wen/agy-staff at commit 65a1ab4, republished under its MIT licence (© keli-wen). 438 words, ~966 tokens.

Download SKILL.mdSave it as .claude/skills/researcher/SKILL.md (or your agent's skills folder).
name
researcher
description
Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini). Use when the user says /agy:researcher, "ask agy to research", "have the agy staffer survey X", or wants a second, independent deep-dive on a topic or codebase without spending the host model's quota.
allowed-tools
Read, Glob, Grep, Bash(node:*), Bash(git:*), Bash(gh:*)
argument-hint
[--continue] [--model <id>|--effort low|medium|high] [--restricted|--unrestricted] [--prompt-file <path>|--stdin] "what to research"

agy researcher

Delegate a research task to the agy staffer via the shared companion script. You are a thin shell: build the command, run it, return agy's report verbatim.

Locating the companion

This skill file lives at <plugin-root>/skills/researcher/SKILL.md; resolve the companion path relative to this skill directory:

bash
node "<skill-dir>/../../companion/agy-companion.mjs" research [flags] --prompt "what to research"

Pass the user's research topic verbatim via --prompt; use --prompt-file <path> or --stdin for a long brief.

[!IMPORTANT] Run this command unsandboxed — agy needs a localhost port and its OAuth token file, which harness sandboxes hide. In Codex, request escalated permissions for the command. Details: ../jobs/references/troubleshooting.md.

Collecting the result

The command returns a job id. Read ../jobs/SKILL.md for result collection and recovery: dispatch, wait for the final result, then validate as needed. Do not proactively observe progress, read logs or inspect intermediate artifacts while running. Observe only when the user explicitly asks for progress; diagnose a failure or a result requiring intervention under the jobs protocol.

Flags (all optional)

  • --continue — reuse the last research conversation (quota-friendly, served largely from cache); --conversation <id> targets a specific one.
  • --model <id> or --effort low|medium|high — default model is gemini-3.8-flash-high.
  • --restricted / --unrestricted — permission profile. research defaults to unrestricted, so it works out of the box with no setup. --restricted is the opt-in hardening path: agy runs without --dangerously-skip-permissions and may only use allowlisted tools, so it needs the setup flow's evidence-gathering allowlist to be useful — and some native agy tools ignore allow-rules headless, so restricted runs can still come back empty.
  • --prompt <text> / --prompt-file <path> / --stdin — the task, from exactly one of these three sources. Use file/stdin for long prompts.
  • --timeout <dur> — default 60m, maximum 120m hard execution limit.
Show full SKILL.md (167 more words)Show less

Rules

  • Do not do the research yourself and do not re-verify agy's findings.
  • Return the companion stdout verbatim. The [agy-staff] telemetry line goes to stderr (and into jobs/<id>.log for background runs) — it is metadata for you, the calling agent, not something to show the user.
  • Pass the user's explicit authorizations through to the task string verbatim. The prompt template default-denies costly or irreversible side effects (commits/pushes, deleting files outside the workspace, side-effectful network calls, commands that burn paid API quota); that default opens only when the request itself asks for the operation — so keep "run the e2e tests" or "call the staging API" in the prompt instead of trimming it.
  • If a --restricted run reports an empty response due to denied permissions, relay the companion's guidance: run the setup flow once (see ../jobs/references/setup.md), or drop --restricted.
  • For errors and recovery, follow ../jobs/SKILL.md.

For an existing conversation, --continue / --conversation <id> inherit its recorded model and permission profile unless explicitly overridden. The unrestricted defaults above apply to new tasks.

© keli-wen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/researcher of keli-wen/agy-staff.

Open the folder on GitHubat commit 65a1ab4

Compare with similar skills

Researcher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Researcher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Researcher this skillkeli-wen/agy-staff733—~966Automated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Deep Researchsanjay3290/ai-skills4329 repos~683Automated safety check: NotesApache-2.0
Horizontal-Vertical Deep ResearchKKKKhazix/khazix-skills21k—~2.1kAutomated safety check: PassMIT
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence

Similar skills

  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed

  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    432 GitHub starsUsed in 9 repos~683 tokens
    Research & ScienceAuto-check: notes

  • Horizontal-Vertical Deep Research

    KKKKhazix/khazix-skills

    Runs a two-axis deep research method on a product, company, concept or person: its full history over time, compared with peers today, delivered as a typeset PDF report.

    21k GitHub stars~2.1k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed

  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed

  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed

More from keli-wen/agy-staff

All 13 skills in this repo

  • Agy Reviewer

    keli-wen/agy-staff

    Get a second-opinion review from Google's Antigravity CLI (agy staffer, fast Gemini) - of code (a diff, PR, working tree) or of a decision, plan, or design.

    733 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed

  • Jobs

    keli-wen/agy-staff

    Manage agy staffer background jobs - collect results, check status, cancel, follow-up conversation, and setup.

    733 GitHub stars~2.7k tokensUpdated 4 days ago
    Auto-check passed

  • Reviewer

    keli-wen/agy-staff

    Get a second-opinion review from Google's Antigravity CLI (agy staffer, fast Gemini) - of code (a diff, PR, working tree) or of a decision, plan, or design.

    733 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed

  • Agy Ask

    keli-wen/agy-staff

    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.

    733 GitHub stars~915 tokensUpdated 4 days ago
    Auto-check passed

  • Agy Lead

    keli-wen/agy-staff

    Orchestrate an ongoing task with AGY while the current agent owns key decisions, review, and delivery.

    733 GitHub stars~1.6k tokensUpdated 4 days ago
    Auto-check passed

  • Agy Researcher

    keli-wen/agy-staff

    Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini).

    733 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Researcher

What does Researcher do?

Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini). Researcher is an agent skill from keli-wen/agy-staff. Delegate a deep research or survey task to Google's Antigravity CLI (agy staffer, fast Gemini).

When should I use Researcher?

Researcher fits situations like: the user says /agy:researcher; ask agy to research; have the agy staffer survey X; independent deep-dive on a topic.

How do I install Researcher in Claude Code?

Run `npx skills add keli-wen/agy-staff --skill researcher -a claude-code`. Or copy the skill folder (skills/researcher in keli-wen/agy-staff) into .claude/skills/researcher in your project. Claude Code loads it when a task matches its description.

How do I install Researcher in Codex?

Run `npx skills add keli-wen/agy-staff --skill researcher -a codex`. Or copy the skill folder (skills/researcher in keli-wen/agy-staff) into .agents/skills/researcher in your project. Codex loads it when a task matches its description.

Can I use Researcher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add keli-wen/agy-staff --skill researcher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/researcher, .gemini/skills/researcher, .github/skills/researcher and .opencode/skills/researcher in your project.

What does Researcher need to run?

Going by SKILL.md and its folder, Researcher needs the command-line tools its instructions call (node). Its frontmatter pre-approves these tools: Read, Glob, Grep, Bash(node:*), Bash(git:*), Bash(gh:*).

Does Researcher access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Researcher safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Researcher use?

Researcher is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Researcher use?

About 966 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Researcher?

Skills that share tags, products or a category with Researcher: GitHub Deep Research (bytedance/deer-flow, 84k stars), Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), Deep Research (sanjay3290/ai-skills, 432 stars) and Horizontal-Vertical Deep Research (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Researcher?

keli-wen (a GitHub user) maintains it in keli-wen/agy-staff, which has 733 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 7, 2026.

Source: keli-wen/agy-staff on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.