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