Gmail Modify Labels

Atomic node skill to modify email labels in Gmail using the gog CLI.

Security Scan

The skill's declared purpose (modify Gmail labels) aligns with its instructions (run the gog CLI to modify messages); it is instruction-only and does not request extra credentials or perform unexpected actions.

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.

Assessment

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.

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.

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:

1. Execute Node: Execute the native terminal command gog gmail messages modify <messageId> ... or equivalent label command.
2. 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.