FlowRelay FlowRelay Docs Shopify Flow Search /
Website → Set up FlowRelay →
All docs pages

START

USE CASES

SET UP

OPERATE

RECOVER

AGENT ACCESS

REFERENCE

Agent Access

FlowRelay Operator Skill

The FlowRelay Operator Skill gives agents a controlled playbook for Shopify Flow event operations without making skills a second authority.

Open the reference Read CLI Reference.

Agent workflow

Agents should orient through docs before using authenticated tools.

  1. Install from the public source

    Install or reference the FlowRelay Operator Skill from the public source links below.

  2. Orient through canonical sources

    Start each task from /llms.txt, the relevant Markdown docs page, /agent/v1/manifest, and OpenAPI before authenticated work.

  3. Choose the mission

    Use mission playbooks and availability guidance before translating an operator goal into a tool call.

  4. Check plan usage

    Check /agent/v1/plan-usage before loops, broad reads, or repeated action previews.

  5. Choose the right operation surface

    Use the skill to choose between docs, Agent Operations API, CLI, and MCP Agent Operations access.

  6. Stay inside the grant

    Keep every action inside the merchant-authorized grant and the documented safety boundary.

  7. Escalate human-only work

    Escalate to a human for billing approval, grant changes, Shopify Flow edits, raw private data, or anything outside the grant.

Authority boundary

  • The skill is broad in usefulness and narrow in authority: the Shopify Flow edition only, no raw event bodies or secrets, no silent replay, no billing approval, no grant escalation, no downstream completion claims, and no future-platform claims.

  • Revoke the grant when the work is finished or when the partner no longer needs access.

  • Review audit entries for sensitive reads, action previews, confirmations, replays, and diagnostics shares.

Installable source #

Use the raw skill file as the installable instruction source. The optional OpenAI metadata file is published beside it for clients or packaging flows that support sidecar metadata. If a client asks for a URL, use the raw SKILL.md link.

Install choices #

Different agent clients install skills differently. Use the raw SKILL.md URL for exact install text; the human page explains scope, safety, and related references.

Installable skill source Use this URL in clients that install from a raw skill file. 
https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/SKILL.md
Human setup page Use this page to understand scope, safety, and related references. 
https://docs.flowrelay.app/agent-access/skills/
OpenAI-compatible metadata Optional sidecar metadata for packaging flows that support it. 
https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/agents/openai.yaml

What it covers #

The Operator Skill guides agents through Shopify Flow event operations. It does not grant, widen, or override any boundary - docs, manifest, OpenAPI, and the active grant remain the authority.

The skill covers setup orientation, mission routing, availability checks, trigger variant and mapping choices, receipt interpretation, event investigation, replay previews, diagnostics shares, support requests, expansion requests, feature requests, and API/CLI/MCP surface selection.

Verify after installation #

After installation, have the client show the loaded FlowRelay skill source or its recorded source URL. Confirm it points to the public raw SKILL.md URL, compare any client-reported SHA-256 digest with the digest in /.well-known/agent-skills/index.json, and inspect the loaded instructions for the Shopify Flow edition boundary and current docs links. If the client cannot expose source or digest information, treat installation as unverified and use the public skill URL directly for the task.

Local docs search