# 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 making skills a second authority.

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

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

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

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


## 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 share endpoint secrets, authentication headers, HMAC values, tokens, raw event bodies, customer records, Shopify sessions, store passwords, or database URLs in public examples.