gf_agent

Generate and execute Google Apps Script code locally with gas-fakes in Node.js.

78|17|Updated Feb 12, 2025
One-click install
npx skills add https://github.com/brucemcpherson/gas-fakes --skill gf-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gf_agent
Source: https://github.com/brucemcpherson/gas-fakes/tree/main/gf_agent
Command: npx skills add https://github.com/brucemcpherson/gas-fakes --skill gf-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

gf_agent simplifies building and running Google Apps Script tasks locally, eliminating the need to deploy or run live GAS for testing and automation.

Core Features & Use Cases

  • Automate Google Workspace tasks locally by generating GAS code and executing it with gas-fakes in Node.js.
  • Use Gemini CLI to describe tasks in plain language and translate them into working scripts.
  • Example: Generate a script that summarizes the latest emails and writes the results to a Google Doc.

Quick Start

Describe a task to automate in plain English and gf_agent will generate and run the corresponding GAS code locally.

Frequently Asked Questions about gf_agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Google Workspace tasks locally without deploying to Google Apps Script?

You can automate Google Workspace tasks locally by generating Google Apps Script code and executing it within a Node.js environment using gas-fakes, eliminating the need for live deployments.

What do I need to set up to run Google Apps Script code in a local Node.js environment?

To run Google Apps Script locally, you need a Node.js setup with gas-fakes installed and an appsscript.json manifest that explicitly declares your required OAuth scopes.

Can I use plain language to generate Google Apps Script for Google Workspace automation?

Yes, you can describe your automation tasks in plain English, and the system uses the Gemini CLI to translate those descriptions into working Google Apps Script code for local execution.

How does local Google Apps Script execution handle Google services like Gmail and Google Docs?

Local Google Apps Script execution coordinates code generation and runtime execution across Google services using gas-fakes, allowing you to summarize emails and write results to a Doc locally.

What are the limitations of using gas-fakes for local Google Apps Script development?

Since gas-fakes runs locally in Node.js, it simulates Google services rather than executing live API calls, meaning actual Google Workspace data is not modified during local testing and automation runs.

Do I need an appsscript.json manifest to test Google Apps Script tasks locally?

Yes, an appsscript.json manifest is required to declare OAuth scopes, ensuring the local gas-fakes runtime correctly simulates the necessary Google Workspace service permissions.