Gmail Search Emails

Atomic node skill to search for emails in Gmail using the gog CLI.

Security Scan

The skill's requirements and instructions match its stated purpose (search Gmail via the gog CLI); it is narrowly scoped and has no surprising install or environment demands, but the evaluator cannot verify how gog is authenticated.

Purpose & Capability

Name and description state: search Gmail using the gog CLI. The only declared runtime requirement is the gog binary, which is exactly what the SKILL.md tells the agent to invoke. There are no unrelated binaries or env vars requested.

Instruction Scope

SKILL.md gives a single, constrained runtime directive: call `gog` with `gmail search "query" --json`. It does not instruct the agent to read unrelated files, exfiltrate data to unknown endpoints, or perform privilege-escalating actions.

Install Mechanism

No install specification — instruction-only. Nothing is downloaded or written to disk by the skill itself, which minimizes installation risk.

Credentials

The skill declares no env vars or credentials, which is coherent if the gog CLI is already installed and pre-authenticated. However, accessing Gmail requires authentication (OAuth tokens or similar) that the skill assumes will be provided by the gog CLI or the environment; the skill does not document or request those credentials. Users should verify how gog is authenticated and which Gmail account it will access.

Persistence & Privilege

Skill is not always-enabled and does not request persistent system modifications or elevated privileges. It is user-invocable and follows normal autonomous invocation defaults.

Assessment

This skill appears consistent with its description: it simply runs the local `gog` CLI to search Gmail. Before installing, ensure (1) you trust the `gog` binary (source, integrity), (2) you understand which Gmail account/credentials `gog` is configured to use (it likely uses local OAuth tokens or a config file), and (3) you are comfortable letting an agent invoke `gog` to read/search your messages. If you need tighter control, test in a non-sensitive account or verify/limit `gog`'s permissions first.

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 search fails.

This skill allows the agent to search for emails in Gmail using specific queries with the native CLI.

Cognitive Directives

WHEN [Requested to search for an email or find specific communications] THEN [Invoke the gog tool with the argument gmail search "query" --json]

Schema Example

{
  "args": "gmail search \"from:[e-mail] subject:invoice\" --json"
}

Expected Output

A JSON array containing email headers (id, threadId, snippet) or a "no results found" message.