← Back to Skills Marketplace
65
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install gmail-delete-email
Description
Atomic node skill to delete an email via Gmail using the gog CLI.
README (SKILL.md)
Lean Philosophy (Principles)
- Kaizen (改善): This skill is an atomic node, broken down into its simplest, smallest component to eliminate waste and ensure perfection.
- Standardized Work (Hyojun Sagyo): This node represents the most efficient, standardized path for this specific task before automation.
- Jidoka (自働化): This node includes autonomous defect detection. It relies on the CLI's self-healing loop and will report errors if deletion fails.
Gmail Delete Email
This skill allows the agent to move an email to the trash using the native CLI.
Cognitive Directives
WHEN [An email needs to be deleted or moved to trash] THEN [ Execute the following Jidoka-validated loop:
- Execute Node: Execute the native terminal command
gog gmail trash \x3CmessageId>. - Verification Step (Jidoka): Check if the command returns a successful confirmation. IF it fails or returns an error, wait 3 seconds and retry (max 3 times). IF it still fails, report the error to the user and STOP. ]
Schema Example
{
"command": "gog gmail trash msg_id_123"
}
Expected Output
Confirmation that the email was moved to the trash.
Usage Guidance
This skill simply runs `gog gmail trash <messageId>` and relies on the gog CLI being installed and already authenticated. Before installing: (1) verify the gog binary on your system is from a trusted source and is the intended tool; (2) confirm which Gmail account/gog config will be used (gog likely reads local OAuth tokens or config files); (3) be aware this performs a destructive action—test with a noncritical message first; (4) consider requiring explicit user confirmation before letting an autonomous agent invoke deletion. If you need the skill to handle authentication, expect it to require additional declared credentials/config paths; their absence here means the skill depends on existing local gog setup.
Capability Analysis
Type: OpenClaw Skill
Name: gmail-delete-email
Version: 1.0.3
The skill is a straightforward implementation for deleting Gmail messages using the 'gog' CLI. The instructions in SKILL.md are focused on the stated task, including a basic retry loop for error handling, and do not contain any indicators of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The skill's name/description match the instructions: it runs a single gog command to trash an email. Requiring the gog binary is appropriate for this purpose.
Instruction Scope
SKILL.md confines runtime behavior to executing `gog gmail trash <messageId>` with a simple retry loop and error reporting. It does not instruct the agent to read unrelated files, environment variables, or exfiltrate data.
Install Mechanism
No install spec or code files are present (instruction-only), so nothing is written or downloaded by the skill itself. This is the lowest-risk install posture.
Credentials
The skill requests no environment variables or credentials, which is proportional. Note: successful execution depends on the gog CLI already being installed and authenticated (via its own local config or token store). The skill does not declare or manage those credentials.
Persistence & Privilege
always is false and the skill does not request elevated or persistent platform privileges. The agent may invoke it autonomously (default), which is expected for skills but worth considering in operational policy because this skill performs destructive actions (deleting mail).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-delete-email - After installation, invoke the skill by name or use
/gmail-delete-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Added explicit Jidoka-validated retry loop for error handling.
- Now retries failed delete commands up to 3 times, waiting 3 seconds between attempts.
- Reports error to the user and stops if deletion fails after all retries.
- Documentation updated to clarify these new reliability and verification steps.
v1.0.2
- Updated the skill to use the native gog CLI instead of the GoogleWorkspace plugin for deleting emails.
- Changed requirements from plugin dependency to CLI binary (`gog`).
- Updated description and instructions to reflect the new command-line interface.
- Modified schema example and output expectations accordingly.
v1.0.1
- Expanded OS support from Windows to all operating systems.
- No functionality changes; documentation only.
v1.0.0
- Initial release of the Gmail Delete Email skill.
- Allows deletion of a specific email using the GoogleWorkspace plugin.
- Implements lean principles: atomic design, standardized process, and autonomous error detection.
- Requires the google-workspace-plugin to function.
- Confirms deletion with a JSON response.
Metadata
Frequently Asked Questions
What is Gmail Delete Email?
Atomic node skill to delete an email via Gmail using the gog CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.
How do I install Gmail Delete Email?
Run "/install gmail-delete-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Delete Email free?
Yes, Gmail Delete Email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Delete Email support?
Gmail Delete Email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Delete Email?
It is built and maintained by zvirb (@zvirb); the current version is v1.0.3.
More Skills