Skip to content

Guide · Agent skill

How to use the Project Manager agent skill (persona-project-manager)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The Project Manager skill is an agent skill for Google Workspace that turns your AI agent into a project-coordination assistant. It can summarise your week, log updates to a Google Sheet, share project files through Drive, schedule team standups and draft status emails. This guide explains what an agent skill is, how to install this one, how to ask for its tasks in plain language, and what to check before it sends anything.

Project Managergoogleworkspace/cli · Apache-2.0

Quick start

  1. 1Install gws and sign in. Install the gws command-line tool and authenticate it to your Google account. The skill cannot run without it.
  2. 2Install the five companion skills. Add gws-drive, gws-sheets, gws-calendar, gws-gmail and gws-chat alongside this skill.
  3. 3Download and unzip the skill. Download the ZIP from this page and unzip it to ~/.claude/skills/ or a project's .claude/skills/ folder.
  4. 4Or upload it in the Claude apps. Go to Settings, then Capabilities, then Skills, and upload the skill.
  5. 5Ask in plain language. Request a weekly digest, a status log, a file announcement, a standup or a status email.
  6. 6Preview writes. Add --dry-run to write operations and check the output before anything is sent or created.

What is an agent skill, and what does this one do?

An agent skill is a packaged set of instructions that an AI agent loads when it needs to perform a particular kind of task. This one, persona-project-manager, is licensed under Apache-2.0 and comes from the googleworkspace/cli project. Its description is: coordinate projects by tracking tasks, scheduling meetings and sharing docs.

Once installed, the skill tells the agent to work as a project coordinator inside Google Workspace. It is built around three workflows: a weekly digest, a standup report and a file announcement.

  • Weekly snapshot of upcoming meetings and unread items (gws workflow +weekly-digest)
  • Project status logging into Google Sheets (gws sheets +append)
  • Uploading project files to Google Drive and announcing them (gws drive +upload, gws workflow +file-announce)
  • Recurring team standup meetings with attendees (gws calendar +insert)
  • Status update emails to stakeholders (gws gmail +send)

What you need before installing

The skill does not work on its own. It calls the gws command-line tool (Google Workspace CLI), which must be installed and signed in to a Google account. The skill also depends on five companion skills: gws-drive, gws-sheets, gws-calendar, gws-gmail and gws-chat. Optionally, jq can filter output. You also need access to the Drive files, calendars and mailboxes you want the agent to work with.

  • gws command-line tool installed and authenticated to a Google account
  • Companion skills: gws-drive, gws-sheets, gws-calendar, gws-gmail, gws-chat
  • Optional: jq for filtering output
  • Access to the relevant Google Workspace files, calendars and mailboxes

Install the skill from the ZIP or the Claude apps

Download the ZIP for this skill from this page and unzip it. The package contains SKILL.md. For a personal setup, place the unzipped folder in ~/.claude/skills/. To limit it to one project, place it in that project's .claude/skills/ folder instead.

If you use the Claude apps, you can upload the skill instead. Open Settings, go to Capabilities, then Skills, and upload the skill there. Remember to install the five companion skills the same way, because this skill loads them.

  • Personal install: ~/.claude/skills/
  • Project-only install: the project's .claude/skills/ folder
  • Claude apps: Settings → Capabilities → Skills
~/.claude/skills/persona-project-manager/SKILL.md

Trigger the skill with natural requests

You do not need to type a special command. Ask for what you want in plain language, and name the Workspace tool involved so the agent knows where to look. The skill's own instructions describe the actions it supports, so phrasing requests around those actions works best.

Good requests describe the outcome: the time window, the sheet or folder, and who should receive the result.

  • "Give me my weekly digest of upcoming meetings and unread items."
  • "Log today's status for the website redesign in the project tracker sheet."
  • "Upload the final spec to the Launch folder in Drive and announce it to the team."
  • "Set up a recurring 15-minute standup on weekdays with everyone on the product team."
  • "Draft a status update email to stakeholders and show it to me before sending."

Find project folders and filter results

The skill's tips show how to search Drive for project folders with a name query. They also suggest piping triage output through jq to filter by sender or subject. Use dry-run mode before any write operation to preview what will happen.

  • Find folders: gws drive files list --params '{"q": "name contains \'Project\'"}'
  • Filter triage output by sender or subject by piping it through jq
  • Preview writes first with --dry-run
gws drive files list --params '{"q": "name contains \'Project\'"}'

Safety: scripts, network and sending

This skill runs scripts and uses the network. It can send email and create meetings that notify other people, so do not let it act on important communications without review. Use --dry-run before write operations, and check the recipients, dates and attendee lists it proposes.

Only grant access to the files, calendars and mailboxes the work actually needs. The skill can act on anything your signed-in gws account can reach.

  • Use --dry-run before any write operation
  • Review email drafts and invite attendees before sending
  • Limit Workspace access to what the project needs

What people use it for

  • Start each Monday with a digest of upcoming meetings and unread items.
  • Keep a running project status log in a Google Sheet.
  • Upload a new deliverable to a Drive folder and announce it to the team.
  • Set up recurring team standups with every member invited.
  • Draft stakeholder status emails for review before sending.

Frequently asked questions

How do I install the persona-project-manager skill?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for one project. In the Claude apps you can instead upload it under Settings, then Capabilities, then Skills.

What do I need before the Project Manager skill works?

You need the gws command-line tool installed and signed in to a Google account, plus the companion skills gws-drive, gws-sheets, gws-calendar, gws-gmail and gws-chat. jq is optional for filtering output. Without Google Workspace the skill has no effect.

Is the Project Manager skill free to use?

The source does not state pricing. The skill is licensed under Apache-2.0, so check the repository's licence file for its terms, and check what your Google Workspace plan requires.

Can the skill send emails or create meetings without asking me?

It can. The skill includes a send command and a calendar insert command, and meeting invites notify other people. Use --dry-run first and review drafts and attendee lists before anything goes out.

Does it work with Jira or Asana?

No. The skill works through Google Workspace only and does not connect to dedicated project tools like Jira or Asana.

Why does the skill fail or do nothing?

The most likely causes are that gws is not installed or not signed in, or that a companion skill is missing. Confirm the gws tool is authenticated to the right Google account and that you have access to the Drive files, calendars and mailboxes involved.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits team leads and project managers who run projects in Google Drive, Sheets, Calendar and Gmail, especially if they are comfortable with command-line tools. It is a poor fit if you do not use Google Workspace or need a dedicated tracker like Jira or Asana. Anyone who wants fully unattended sending should review its output carefully, because it can email and invite people directly.

Download the skill