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

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

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


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


## Related
- [Agent orientation](https://docs.flowrelay.app/agent-access/agent-orientation.md)
- [Choose an agent mission](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.