estuary-flowctl-setup

estuary-flowctl-setup is a skill for Claude Code from estuary/agent-skills. It costs 125 tokens per session (1,043 once invoked), scanned B, original, Apache-2.0.

A setup guide for flowctl, Estuary's command-line tool for managing data captures, materializations, collections, and derivations.

In plain words
What is it for?
Use it to install, authenticate, upgrade, or configure flowctl for Estuary work and continuous-integration pipelines.
Why use it?
It explains how to install flowctl on supported systems and handle authentication, including Windows limitations and ARM compatibility issues.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the estuary-operations plugin — 8 skills shipped together

Good fit Use it to install, authenticate, upgrade, or configure flowctl for Estuary work and continuous-integration pipelines.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/estuary/agent-skills/estuary-flowctl-setup
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add estuary/agent-skills --skill estuary-flowctl-setup
Clone the repo
git clone --depth 1 https://github.com/estuary/agent-skills

Made for: Claude Code.

Or install estuary-operations, the plugin that ships this one along with the rest of its 8 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for estuary-flowctl-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/estuary/agent-skills/estuary-flowctl-setup/github.svg)](https://agentmods.dev/skills/estuary/agent-skills/estuary-flowctl-setup)
Your own site
<a href="https://agentmods.dev/skills/estuary/agent-skills/estuary-flowctl-setup"><img src="https://agentmods.dev/badge/skills/estuary/agent-skills/estuary-flowctl-setup/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for estuary-flowctl-setup

Your own site · 80×15
<a href="https://agentmods.dev/skills/estuary/agent-skills/estuary-flowctl-setup"><img src="https://agentmods.dev/badge/skills/estuary/agent-skills/estuary-flowctl-setup.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 125 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,043 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00125 $0.01043
Opus 5 $0.00063 $0.00522
Sonnet 5 $0.00025 $0.00209
Haiku 4.5 $0.00013 $0.00104

Measured 9d ago against content hash 51a9199c7bc4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade B, and why

estuary-flowctl-setup scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo curl -o /usr/local/bin/flowctl -L 'https://github.com/estuary/flow/releases/latest/download/flowctl-multiarch-macos' && sudo chmod +x /usr/local/bin/flowctl

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

sudo curl -o /usr/local/bin/flowctl -L 'https://github.com/estuary/flow/releases/latest/download/flowctl-multiarch-macos' && sudo chmod +x /usr/local/bin/flowctl
skills/estuary-flowctl-setup/SKILL.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

flowctl Setup — Install, Authenticate, and Update

flowctl is Estuary's CLI for managing captures, materializations, collections, and derivations from the command line.

Install

Mac (Homebrew — recommended)

brew tap estuary/flowctl
brew install flowctl

Mac (direct download)

sudo curl -o /usr/local/bin/flowctl -L 'https://github.com/estuary/flow/releases/latest/download/flowctl-multiarch-macos' && sudo chmod +x /usr/local/bin/flowctl

Linux (x86-64)

sudo curl -o /usr/local/bin/flowctl -L 'https://github.com/estuary/flow/releases/latest/download/flowctl-x86_64-linux' && sudo chmod +x /usr/local/bin/flowctl

Windows

No native Windows build exists. Use one of:

  1. WSL (recommended) — Install Windows Subsystem for Linux, then use the Linux install command above inside your WSL shell.
  2. Remote dev environment — Run flowctl on a cloud Linux VM and connect via your IDE's remote development features.

Note: On ARM-based Windows machines (e.g., Snapdragon/aarch64 under WSL), the x86-64 binary won't work (Exec format error). There is no official ARM build yet — use a remote x86-64 environment or build from source.

Authenticate

Interactive login (local development)

flowctl auth login

This opens your browser to the Estuary dashboard's CLI-API tab. Copy the access token and paste it into the terminal.

Note: Access tokens are short-lived (~1 hour). You'll need to repeat this when the token expires.

Programmatic access (CI/CD and automation)

For non-interactive environments, use a long-lived refresh token:

  1. Go to https://dashboard.estuary.dev/admin/api and generate a refresh token
  2. Set the environment variable:
    export FLOW_AUTH_TOKEN=<your-refresh-token>
    
  3. Run flowctl commands normally — authentication is handled automatically

Important: If a config file exists for the current profile, flowctl ignores FLOW_AUTH_TOKEN. Use a separate profile to avoid conflicts:

flowctl --profile ci catalog list

Read the full file on GitHub · 113 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 113 lines · 125 tokens per session scan B 51a9199c7bc4

Subscribe to this mod's changes

estuary-flowctl-setup is a skill published in the GitHub repository estuary/agent-skills (7 stars, last pushed 19d ago), licensed Apache-2.0. It adds 125 tokens to every session and 1,043 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it B with 2 findings (asks for root, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

change-data-capture-admin

Use when enabling, configuring, or monitoring Change Data Capture (CDC) entity selection, channel enrichment, and delivery usage limits from an admin perspective. NOT for writing an Apex change-event trigger — use apex/change-data-capture-apex. NOT for subscribing an external system over Pub/Sub or CometD — use…

PranavNagrecha/AwesomeSalesforceSkills · 76 tokens

change-data-capture-admin

Use when enabling, configuring, or monitoring Change Data Capture (CDC) entity selection, channel enrichment, and delivery usage limits from an admin perspective. NOT for CDC Apex trigger implementation (use change-data-capture-integration).

BanibrataChatterjee/AwesomeSalesforceSkills · 50 tokens

stream-processing-designer

Design a stream processing system for unbounded, continuously arriving data. Use when choosing a message broker (Kafka vs RabbitMQ), implementing change data capture (CDC) from PostgreSQL, MySQL, or MongoDB via Debezium or Maxwell, selecting window types for aggregation (tumbling, hopping, sliding, session), joining…

bookforge-ai/bookforge-skills · 240 tokens

target-connector

This skill should be used when creating a new target connector for CocoIndex to integrate with external systems. It provides guidance on implementing TargetHandler, TargetActionSink, and related types for declarative target state synchronization with change detection and automatic cleanup.

cocoindex-io/cocoindex · 52 tokens

cocoindex

This skill should be used when building data processing pipelines with CocoIndex, a Python library for incremental data transformation. Use when the task involves processing files/data into databases, creating vector embeddings, building knowledge graphs, ETL workflows, or any data pipeline requiring automatic change…

cocoindex-io/cocoindex · 88 tokens

cocoindex-diagrams

This skill should be used when creating, editing, or reviewing inline SVG diagrams for the CocoIndex docs site (anything under docs/src/content/docs/). It encodes the component-based primitive system under docs/src/components/diagrams/, the palette + shape semantics, the preview-and-verify loop using headless Chrome…

cocoindex-io/cocoindex · 124 tokens