Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

persona-researcher — Claude Code skill: what it does, how to install

Sets up an AI researcher persona for Google Workspace. It organizes references in Drive, tracks data in Sheets, and manages review requests.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill persona-researcher -a claude-code
Open on GitHub

What persona-researcher does

This skill configures the agent to manage academic and technical research within Google Workspace. It guides the model to file papers into Google Drive folders, draft summaries with gws docs +write, and log continuous experiment metrics using gws sheets +append.

The persona acts as a coordinator across multiple tools. To function, it strictly requires the gws binary alongside four utility skills: gws-drive, gws-docs, gws-sheets, and gws-gmail. Team collaboration relies on the gws workflow +file-announce routine, while peer review requests are sent directly via gws gmail +send. For data handoffs to statistical tools, it applies the --format csv flag.

Install this if your project workflows already run on Google Drive and Sheets. Without the underlying gws CLI configured, this persona will not work.

What it helps with

  • log experiment results directly using gws sheets +append
  • write summaries and literature notes with gws docs +write
  • organize papers and project assets inside Google Drive folders
  • request peer reviews by sending drafts via gws gmail +send

Example prompts for the agent

  • Find our research notes on Drive using `gws drive files list`
  • Append these test metrics to the shared experiment spreadsheet
  • Share the latest research summary with collaborators via `gws workflow +file-announce`

How to install persona-researcher

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/persona-researcher/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/persona-researcher/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about persona-researcher

How to install persona-researcher in Claude Code?

Run npx skills add googleworkspace/cli --skill persona-researcher -a claude-code. Alternatively, copy the skill file into ~/.claude/skills/persona-researcher/SKILL.md.

What does persona-researcher do?

It defines an agent persona that coordinates research tasks across Google Workspace. The skill guides note-taking in Google Docs, logging in Sheets, and peer reviews over Gmail.

What are the prerequisites for persona-researcher?

You must have the gws binary installed. The agent also requires four companion skills: gws-drive, gws-docs, gws-sheets, and gws-gmail.

Source text

SKILL.md · Apache-2.0
---
name: persona-researcher
description: "Organize research — manage references, notes, and collaboration."
metadata:
  version: 0.22.5
  openclaw:
    category: "persona"
    requires:
      bins:
        - gws
      skills:
        - gws-drive
        - gws-docs
        - gws-sheets
        - gws-gmail
---

# 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 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor