Docs
CLI

CLI Skills

Breyta CLI skills setup guide for Codex, Cursor, Claude Code, and Gemini CLI agent runtimes.

Quick Answer

Recommended: run breyta init --provider <provider> to install the Breyta skill bundle and create a local breyta-workspace/ with an AGENTS.md file for reliable agent context.
The generated AGENTS.md uses draft-first release hygiene: iterate on draft, then release to live once after approval.
It also front-loads the current core authoring pattern: inventory and test
connections first, shape :requires around stable capability slots, then build
reusable definitions (:templates, :functions, packaged :steps,
:agents) before filling in :flow. For human-facing flows, the skill bundle
also tells agents to design the final output artifact up front: usually a
Markdown report, with breyta-resource embeds when the report needs real
Breyta tables, charts, downloads, media, text, or JSON resources.

If you only want the skill bundle, use breyta skills install --provider <provider>.

Do This Now

Recommended (skill + workspace instructions):

breyta init --provider codex
breyta init --provider cursor
breyta init --provider claude
breyta init --provider gemini

Skill-only:

breyta skills install --provider codex
breyta skills install --provider cursor
breyta skills install --provider claude
breyta skills install --provider gemini

Install for the provider used by your active runtime (codex, cursor, claude, or gemini).

What This Does

  • installs Breyta skill files to provider-specific locations
  • installs SKILL.md plus bundled playbooks/ and references/ files for task-specific guidance
  • enables agent-assisted flow authoring and operations
  • does not change deployed flow runtime behavior
  • breyta init also creates a folder with AGENTS.md to keep instructions in the agent context
  • the generated guidance biases agents toward connection-first, definition-first authoring instead of putting heavy config directly in :flow
  • the compact SKILL.md tells agents which playbook or reference to load for authoring, debugging, release/install, public flows, output rendering/resources/tables, provider API freshness, and reliability work

When To Use

Use when setting up or updating an agent environment.

Advanced Options

  • use provider-specific install targets
  • verify install artifacts with local file checks

Go Deeper

As of May 15, 2026