FlowRelay Operator Skill

# FlowRelay Operator Skill

Canonical: https://docs.flowrelay.app/agent-access/skills/
Markdown: https://docs.flowrelay.app/agent-access/skills.md

The FlowRelay Operator Skill gives agents a controlled playbook for Shopify Flow event operations without turning skills into a second source of truth.

## Steps
Complete these in order.
1. Install or reference the FlowRelay Operator Skill from the public source links below.
2. Start each task from /llms.txt, the relevant Markdown docs page, /agent/v1/manifest, and OpenAPI before authenticated work.
3. Use mission playbooks and availability guidance before translating an operator goal into a tool call.
4. Check /agent/v1/plan-usage before loops, broad reads, or repeated action previews.
5. Use the skill to choose between docs, Agent Operations API, CLI, and MCP Agent Operations access.
6. Keep every action inside the merchant-authorized grant and the documented safety boundary.
7. Escalate to a human for billing approval, grant changes, Shopify Flow edits, raw private data, or anything outside the grant.

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

- [Raw SKILL.md](https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/SKILL.md): Installable FlowRelay Operator Skill source.
- [OpenAI metadata](https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/agents/openai.yaml): Optional metadata for OpenAI-compatible skill packaging.

## Install choices
Different agent clients install skills differently. The source of truth is the raw SKILL.md URL; the human page explains scope, safety, and related references.

### Installable skill source
Use this URL in clients that install from a raw skill file.

```sh
https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/SKILL.md
```

### Human setup page
Use this page to understand scope, safety, and related references.

```sh
https://docs.flowrelay.app/agent-access/skills/
```

### OpenAI-compatible metadata
Optional sidecar metadata for packaging flows that support it.

```sh
https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/agents/openai.yaml
```


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


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


## Related
- [Agent orientation](https://docs.flowrelay.app/agent-access/agent-orientation.md)
- [Agent mission playbooks](https://docs.flowrelay.app/agent-access/agent-mission-playbooks.md)
- [Availability and refusals](https://docs.flowrelay.app/agent-access/availability-and-refusals.md)
- [API Reference](https://docs.flowrelay.app/reference/api.md)
- [CLI Reference](https://docs.flowrelay.app/reference/cli.md)
- [MCP Reference](https://docs.flowrelay.app/reference/mcp.md)

## Safety Boundary
Do not include raw event bodies, endpoint secrets, authentication headers, HMAC values, Shopify tokens, Shopify sessions, database URLs, customer data, merchant incidents, or copied private logs in public examples.