Persona Researcher
Run a Google Workspace–backed research persona that files papers in Drive, logs experiments in Sheets, and shares findings via Docs, Gmail, and announce workflows.
Overview
Persona-researcher is an agent skill for the Idea phase that organizes research references, notes, and collaboration through Google Workspace via the gws CLI.
Install
npx skills add https://github.com/googleworkspace/cli --skill persona-researcherWhat is this skill?
- Prerequisite stack: load gws-drive, gws-docs, gws-sheets, and gws-gmail before operating as Researcher
- Drive folder organization plus docs +write for summaries and running research notes
- Sheets +append for experiment and findings data logging with CSV export for analysis tools
- Collaboration via gws workflow +file-announce and peer review requests through gws gmail +send
- Drive files list with search queries to locate documents across a growing reference library
- 4 prerequisite utility skills (gws-drive, gws-docs, gws-sheets, gws-gmail)
- metadata version 0.22.5
Adoption & trust: 16.2k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your research papers, experiment logs, and collaborator updates live in ad-hoc folders and chat threads instead of a shared, searchable workspace.
Who is it for?
Solo builders or tiny teams already on Google Workspace who want an agent persona to manage literature, lab-style logging, and share-outs without building a custom CMS.
Skip if: Builders without `gws` installed, without the prerequisite gws-* skills, or who need non-Google research stacks (Zotero-only, Notion-only) with no Workspace integration.
When should I use this skill?
Organize research — manage references, notes, and collaboration with Google Workspace via gws.
What do I get? / Deliverables
After loading the four gws utility skills, your agent maintains Drive structure, Docs summaries, Sheets logs, and Gmail or workflow announcements for peer review.
- Organized Drive folders for papers and notes
- Research summaries in Docs and append-only experiment logs in Sheets
- Collaborator announcements and peer-review email requests
Recommended Skills
Journey fit
Canonical shelf is Idea because the persona is built around organizing references, notes, and collaborator handoffs before product commitments. Research subphase fits reference management, experiment logs, and peer-review requests—the core loop described in the skill.
How it compares
A persona orchestration layer over gws skills—not a standalone MCP server or a generic note-taking template.
Common Questions / FAQ
Who is persona-researcher for?
Indie builders and researchers who use the googleworkspace CLI and want one persona that ties Drive, Docs, Sheets, and Gmail into a consistent research workflow.
When should I use persona-researcher?
During Idea-phase research when you are collecting papers, writing summaries, logging experiments in Sheets, and coordinating reviews—especially before you freeze scope for a validate or build sprint.
Is persona-researcher safe to install?
It delegates to Google APIs through gws; review the Security Audits panel on this page and treat Workspace permissions and OAuth scopes as you would for any agent with mail and file access.
SKILL.md
READMESKILL.md - Persona Researcher
# 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.