← Back to Skills Marketplace
104
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install gmail-modify-labels
Description
Atomic node skill to modify email labels in 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 the modification fails.
Gmail Modify Labels
This skill allows the agent to add or remove labels from an email or thread using the native CLI.
Cognitive Directives
WHEN [Labels on an email need to be changed, added, or removed] THEN [ Execute the following Jidoka-validated loop:
- Execute Node: Execute the native terminal command
gog gmail messages modify \x3CmessageId> ...or equivalent label command. - Verification Step (Jidoka): Verify the command returns a successful confirmation. IF it fails or returns an error message, 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 messages modify msg_id_123 --add-label INBOX --remove-label UNREAD --json"
}
Expected Output
Confirmation that the labels were updated.
Usage Guidance
This skill appears coherent for changing Gmail labels via the gog CLI, but it will act using whatever Gmail account the gog tool is already authenticated to. Before installing/use: 1) verify the gog binary you have is the legitimate CLI you expect and is installed intentionally; 2) confirm which Gmail account and OAuth scopes gog is configured with (so the skill doesn't modify the wrong mailbox); 3) if possible test with a non-production account or a single test message; 4) limit autonomous invocation or agent privileges if you do not want the agent to change mail without explicit approval.
Capability Analysis
Type: OpenClaw Skill
Name: gmail-modify-labels
Version: 1.0.3
The skill provides instructions for an AI agent to execute shell commands using a CLI tool named 'gog' to modify Gmail labels. While the behavior is aligned with the stated purpose in SKILL.md, the reliance on direct terminal execution with unvalidated placeholders (e.g., <messageId>) introduces a potential shell injection vulnerability. Per the evaluation criteria, the use of shell access for the stated purpose is classified as suspicious rather than benign or malicious.
Capability Assessment
Purpose & Capability
The name, description, and SKILL.md consistently describe using the gog CLI to modify Gmail message/thread labels. Requiring the gog binary is proportional to the stated task.
Instruction Scope
Instructions are narrowly scoped to calling the gog gmail messages modify command and verifying success with a simple retry loop. The SKILL.md does not ask the agent to read unrelated files or environment variables. However, it implicitly relies on the local gog CLI being installed and authenticated; the skill will run with whatever account/context the gog CLI is configured to use.
Install Mechanism
There is no install specification and no code written to disk (instruction-only), so the skill does not download or install additional software itself.
Credentials
The skill declares no environment variables or credentials, which is reasonable since it relies on the gog CLI. That said, the gog CLI typically uses on-disk OAuth tokens or local config for authentication — the skill will operate with those credentials implicitly. Users should recognize that the skill can act as the account authenticated to gog.
Persistence & Privilege
always is false and the skill does not request persistent system changes or modifications to other skills or agent-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-modify-labels - After installation, invoke the skill by name or use
/gmail-modify-labels - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Added a Jidoka-validated loop: on command failure, retry up to 3 times with 3-second intervals; if still unsuccessful, report the error and stop.
- Updated Cognitive Directives section to reflect the error-handling and retry process.
v1.0.2
- Switched the implementation to use the native gog CLI instead of the Google Workspace plugin.
- Updated requirements to specify the need for the gog binary.
- Revised schema example to reflect CLI command usage.
- Adjusted output description to align with the CLI-based workflow.
- Updated documentation to describe CLI operation and new cognitive directives.
v1.0.1
- Expanded operating system support from "windows" to "all" in SKILL.md.
v1.0.0
- Initial release of Gmail Modify Labels skill.
- Enables batch addition and removal of labels from an email using the GoogleWorkspace plugin.
- Provides a simple JSON schema for specifying email ID and label changes.
- Reports errors if operations fail, leveraging plugin's error handling.
Metadata
Frequently Asked Questions
What is Gmail Modify Labels?
Atomic node skill to modify email labels in Gmail using the gog CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 104 downloads so far.
How do I install Gmail Modify Labels?
Run "/install gmail-modify-labels" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Modify Labels free?
Yes, Gmail Modify Labels is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Modify Labels support?
Gmail Modify Labels is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Modify Labels?
It is built and maintained by zvirb (@zvirb); the current version is v1.0.3.
More Skills