Agent skill

Persona Researcher

by googleworkspace in googleworkspace/cli

Organize research — manage references, notes, and collaboration.

Apache-2.0Auto-check passedProductivity & Automation

Install Persona Researcher

skills CLI
$ npx skills add googleworkspace/cli --skill persona-researcher -a claude-code

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

GitHub CLI
$ gh skill install googleworkspace/cli persona-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/googleworkspace/cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/persona-researcher .claude/skills/persona-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
persona-researcher
GitHub stars
31k
Token cost
~281 tokens
SKILL.md length
107 words
Files
1
Skills in repo
77
Repo updated
First seen
Licence
Apache-2.0

At a glance

Organize research — manage references, notes, and collaboration.

  • Productivity & Automation work in your project
  • SKILL.md covers Relevant Workflows, Instructions and Tips
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Persona Researcher is an agent skill from googleworkspace/cli. Organize research — manage references, notes, and collaboration.

Its SKILL.md is about 280 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 Productivity & Automation. It works with Google Workspace and Gmail. The repository describes itself as: Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent… The licence is Apache-2.0.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/persona-researcher”

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Persona Researcher loads about 281 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 107 words of instructions outside code blocks.

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

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 googleworkspace/cli at commit a3768d0, republished under its Apache-2.0 licence (© googleworkspace). 107 words, ~281 tokens.

Download SKILL.mdSave it as .claude/skills/persona-researcher/SKILL.md (or your agent's skills folder).
name
persona-researcher
description
Organize research — manage references, notes, and collaboration.
metadata.version
0.22.5

Researcher

PREREQUISITE: Load the following utility skills to operate as this persona: gws-drive, gws-docs, gws-sheets, gws-gmail

Organize research — manage references, notes, and collaboration.

Relevant Workflows

  • gws workflow +file-announce

Instructions

  • Organize research papers and notes in Drive folders.
  • Write research notes and summaries with gws docs +write.
  • Track research data in Sheets — use gws sheets +append for data logging.
  • Share findings with collaborators via gws workflow +file-announce.
  • Request peer reviews via gws gmail +send.

Tips

  • Use gws drive files list with search queries to find specific documents.
  • Keep a running log of experiments and findings in a shared Sheet.
  • Use --format csv when exporting data for analysis tools.

© googleworkspace, Apache-2.0. 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/persona-researcher of googleworkspace/cli.

Open the folder on GitHubat commit a3768d0

Compare with similar skills

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

Persona Researcher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Persona Researcher this skillgoogleworkspace/cli31k—~281Automated safety check: PassApache-2.0
Prismer Google WorkspacePrismer-AI/PrismerCloud1.6k3 repos~4.2kAutomated safety check: PassMIT
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
Google Workspace CLIlaude-institute/headlong1.2k—~1.2kAutomated safety check: PassApache-2.0
Gogtrpc-group/trpc-agent-go1.9k15 repos~1.1kAutomated safety check: PassApache-2.0
Gmail Query Syntaxprovos/ironcurtain612—~971Automated safety check: PassApache-2.0

Similar skills

  • Prismer Google Workspace

    Prismer-AI/PrismerCloud

    Gives an agent account-scoped access to Gmail, Calendar, Drive, Contacts, Docs and Sheets through the gws CLI or a bundled Python client.

    1.6k GitHub starsUsed in 3 repos~4.2k tokens
    Productivity & AutomationAuto-check passed
  • Google Workspace

    yc-software/qm

    Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.

    15k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Google Workspace CLI

    laude-institute/headlong

    Drives Google Drive, Gmail, Calendar, Sheets, Docs and Chat from the shell with the gws CLI, including its sign-in, flags, helper commands and safety rules.

    1.2k GitHub stars~1.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Gog

    trpc-group/trpc-agent-go

    Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

    1.9k GitHub starsUsed in 15 repos~1.1k tokens
    Productivity & AutomationAuto-check passed
  • Gmail Query Syntax

    provos/ironcurtain

    Reference for Gmail's search query syntax — operators like is:sent, newerthan:, from:, has:attachment, label:, and how they compose.

    612 GitHub stars~971 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Email Assistant

    appleweiping/WEIPING_WIKI

    Personal Gmail and Google Workspace email assistant for Vipin.

    119 GitHub stars~1.3k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from googleworkspace/cli

All 77 skills in this repo
  • Gmail Inbox Watcher

    googleworkspace/cli

    Streams new Gmail messages as NDJSON from the gws command line tool using Google Pub/Sub, with label filters, batch settings and optional per-message files.

    31k GitHub starsUsed in 1 repo~476 tokens
    Auto-check passed
  • Workspace Events Subscribe

    googleworkspace/cli

    Subscribes to Google Workspace events with the gws CLI and streams them as NDJSON, with flags for the target resource, event types, Pub/Sub project and output directory.

    31k GitHub stars~509 tokensUpdated 4 days ago
    Auto-check passed
  • Gmail Message Forwarder

    googleworkspace/cli

    Forwards an existing Gmail message to new recipients from the command line with the gws CLI, with options for notes, attachments, CC, BCC and drafts.

    31k GitHub stars~763 tokensUpdated 4 days ago
    Auto-check passed
  • Gmail Reply via gws

    googleworkspace/cli

    Replies to a Gmail message from the gws CLI with automatic threading, plus CC, BCC, extra recipients, attachments, HTML bodies and draft or dry-run modes.

    31k GitHub stars~655 tokensUpdated 4 days ago
    Auto-check passed
  • Gws Calendar Agenda

    googleworkspace/cli

    Google Calendar: Show upcoming events across all calendars. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~389 tokens
    Auto-check passed
  • Gmail Reply-All Command

    googleworkspace/cli

    Replies to everyone on a Gmail message through the gws CLI, with threading handled automatically, options to add or drop recipients, and a draft mode.

    31k GitHub stars~736 tokensUpdated 4 days ago
    Auto-check passed

Questions about Persona Researcher

What does Persona Researcher do?

Organize research — manage references, notes, and collaboration. Persona Researcher is an agent skill from googleworkspace/cli. Organize research — manage references, notes, and collaboration.

When should I use Persona Researcher?

Persona Researcher fits situations like: productivity & Automation work in your project.

How do I install Persona Researcher in Claude Code?

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

How do I install Persona Researcher in Codex?

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

Can I use Persona 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 googleworkspace/cli --skill persona-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/persona-researcher, .gemini/skills/persona-researcher, .github/skills/persona-researcher and .opencode/skills/persona-researcher in your project.

What does Persona Researcher need to run?

SKILL.md names no scripts, command-line tools or credentials: Persona Researcher is instructions for the agent only.

Does Persona 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 Persona 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 Persona Researcher use?

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

How many tokens does Persona Researcher use?

About 281 tokens (SKILL.md is roughly 1.1k 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 Persona Researcher?

Skills that share tags, products or a category with Persona Researcher: Prismer Google Workspace (Prismer-AI/PrismerCloud, 1.6k stars), Google Workspace (yc-software/qm, 15k stars), Google Workspace CLI (laude-institute/headlong, 1.2k stars) and Gog (trpc-group/trpc-agent-go, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Persona Researcher?

googleworkspace (a GitHub organization) maintains it in googleworkspace/cli, which has 31,284 GitHub stars. The repository holds 77 skills in this directory. The repository was last updated on October 6, 2026.

Source: googleworkspace/cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.