OpenParable
Skip to content
← Back to skills

Console Navigator

Apps & Automation
console-navigator

Console Navigator is an Agent Skill for apps & automation published in the zgiai/zgi repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Navigate the visible console to a safe internal page when the user asks to open, switch to, or go to another module.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/zgiai/zgi/blob/HEAD/api/internal/modules/skills/catalog/console-navigator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/console-navigator, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Console Navigator Skill

Use this skill only to request safe internal console navigation. It does not create, edit, delete, publish, run, schedule, send, or otherwise mutate user assets.

Available Routes

  • Home: /console
  • Conversations: /console/work/chat
  • Images: /console/work/image
  • Apps: /console/work/app
  • Scheduled tasks: /console/work/task
  • Agents: /console/agents
  • Agent detail pages from current context when an exact href is known: /console/agents/{agentId}, /console/agents/{agentId}/logs, /console/agents/{agentId}/api, /console/agents/{agentId}/batch-test
  • Workflows: /console/workflows
  • Workflow detail pages from current context when an exact href is known: /console/workflows/{workflowId}, /console/workflows/{workflowId}/logs, /console/workflows/{workflowId}/api, /console/workflows/{workflowId}/batch-test
  • Knowledge bases: /console/dataset
  • Databases: /console/db
  • Files: /console/files
  • Prompts: /console/prompts
  • File recognition: /console/developer/content-parse
  • Workspace: /console/workspace, /console/workspace/members, /console/workspace/settings
  • System settings: /console/settings

Workflow

  1. Use navigate when the user asks to go to, open, switch to, show, or continue in a console module and the destination is in the route list.
  2. If the user only asks what the assistant can do or what a module is for, answer directly from the site map instead of navigating.
  3. If the requested destination is ambiguous, ask one concise clarification.
  4. Do not navigate to external URLs or non-console paths.
  5. If the current page context already matches the requested route, do not call navigate just to create proof. Continue from the current page context and visible resources.
  6. After navigation, pause for the frontend client action result. The sidebar will switch routes, wait for supported target page context, and continue this same assistant turn with the updated page context when available.
  7. Navigation is usually a substep, not the user's final goal. After the loaded-route/page-context evidence arrives, continue the remaining requested operation from the new page context instead of ending the turn just because navigation succeeded.
  8. If a previous tool result or page fact will be needed after navigation, record it with submit_turn_state before calling navigate. Use the stored fact after the continuation instead of re-reading or guessing.
  9. Never claim that navigation performed an asset operation. If the user asks to delete, publish, run, schedule, create, or modify assets, explain that those actions need a supported governed tool and user approval when available.
  10. Agent and Workflow assets are separate console surfaces. Use /console/agents for Agent management and /console/workflows for Workflow management or inspection. Do not route Workflow requests to the Agents list unless the user explicitly asks for Agents.

Tool Usage

navigate accepts:

  • href: required whitelisted internal console route.
  • reason: optional short reason for why that route is relevant.

The tool returns a page_navigation_requested event for the sidebar frontend. The frontend performs a second whitelist check before calling Next Router.

Success Evidence

  • A navigate tool result means the route request was accepted, not that the target page is already loaded.
  • Final navigation success requires frontend client-action evidence such as route_loaded, loaded_href, observed_path, or an equivalent successful page-context continuation matching the requested href. If the current page context already matches the requested href, that current page context is already sufficient route evidence.
  • Do not answer from the old page context after a navigation request. If the route request succeeded but no loaded-page evidence is available yet, say that navigation is pending or wait for the continuation.

Truthfulness Contract

  • Treat client-action route evidence as authoritative for what page is currently visible.
  • If navigation fails, is blocked, or does not produce matching loaded-route evidence, do not claim the page is open. Report the actual navigation state.
  • Retry at most once with a corrected whitelisted href when the route error is recoverable. Do not repeat the same navigation request with identical arguments after a failure.