---
name: explore
description: Read-only repository fact gathering through omagy explore.
argument-hint: "<narrow repo-local lookup prompt>"
---

# Explore

Use this skill for fast, read-only repository fact gathering before planning,
deep interview, Ralph intake, or Team launch.

Run `omagy explore` first for narrow repo-local lookups:

```bash
omagy explore --prompt "<prompt>" --json
```

Good prompts:

- `package.json`
- `cat README.md`
- `search for plan record`
- `run git status --short`
- `run rg "omagy plan" packages/cli/src`

Rules:

- Stay read-only. Do not edit files, write state, run formatters, or execute
  build/test commands from this skill.
- Keep prompts narrow and concrete. Explore is for facts, paths, symbols,
  commands, and implementation patterns, not broad design synthesis.
- If `omagy explore` returns `unsupported_prompt`, use Antigravity's native
  `explorer` subagent or normal read-only inspection for richer investigation.
- Cite files, commands, and exact evidence in the response.
- If repo evidence conflicts with memory or prior assumptions, prefer current
  repo evidence and call out the mismatch.

`omagy explore` is intentionally bounded. It supports local file/path/text
lookups and safe read-only shell routes, but it does not run arbitrary shell
commands.