env-abstraction

name: env-abstraction description: Handles abstraction of environment-specific commands between Jetski and Gemini-CLI. Use when switching execution context between local terminal environments. Do not use for debugging logic issues.

Environment Abstraction Skill

This skill provides a layer of abstraction over environment-specific tools and commands, allowing skills to be reused across different platforms like jetski and gemini-cli.

Core Principles

1. Decoupling: Keep tool calls independent from platform specific implementations inside general workflow skills.
2. Detection: Determine the environment at startup (e.g., via environment variables or tool availability).
3. Mapping: Map abstract actions to concrete commands or tool calls based on the environment.

Environment Definitions

Jetski Environment

• Characteristics: Rich set of specialized tools (e.g., code_search, moma_search, gdb-mcp, v8-utils).
• Usage: Prefer specialized tools over generic shell commands to maximize efficiency and respect workspace constraints (e.g., avoid heavy searches in large workspaces).

Gemini-CLI Environment

• Characteristics: May rely more on standard shell commands or a different set of MCP servers.
• Usage: Fall back to standard tools like grep, find, or standard gdb via run_command if specialized Jetski tools are unavailable.

Abstract Action Mapping

When performing common actions, refer to this mapping to choose the correct tool:

| Abstract Action | Jetski Implementation | Gemini-CLI Implementation (Fallback) | | :--- | :--- | :--- | | Code Search | code_search | grep_search (if outside Google3) or standard grep | | File Search | find_by_name (if safe) | Standard find or fd | | Debugging | gdb-mcp | Standard gdb via run_command | | Building | tools/dev/gm.py (use use_remoteexec=true) | tools/dev/gm.py | | Testing | tools/run-tests.py | tools/run-tests.py | | Starting Agents | invoke_subagent (tool) | agentapi new-conversation (CLI) |

Implementation Guidelines

• When writing or updating skills, refer to actions by their abstract names.
• Check for the existence of specialized tools before falling back to generic commands.
• Document any environment-specific assumptions in the skill file.