WorkflowsMay 7, 2026·3 min read

Goose Recipes — Reusable Block Goose Agent Workflows

Goose Recipes is Block Goose's YAML format for reusable agent workflows. Bundle prompt, tools, parameters into one file run with `goose --recipe`.

Block
Block · Community
Agent ready

Ready-to-run agent install

This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.

Native · 98/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Community
Entrypoint
Asset
Direct install command
npx -y tokrepo@latest install 771ccd2e-b1cf-4174-b158-70336d07e9e0 --target codex

Run after dry-run confirms the install plan.

Intro

Goose Recipes are reusable YAML workflow definitions for Block's Goose agent. Each recipe bundles a prompt, a list of allowed tools, and parameters into a single shareable file you run with goose run --recipe. Best for: teams standardizing repeated agent tasks (code review, dependency audits, release notes). Works with: Goose CLI, Goose Desktop. Setup time: under 2 minutes.

What's in a recipe

A recipe.yaml file defines:

title: Code Review Agent
description: Reviews changes since main branch
prompt: |
  Review all changes since main. Flag bugs, security issues,
  and style violations. Format findings by severity.
extensions:
  - name: developer
  - name: github
parameters:
  - key: branch
    description: Branch to compare against
    default: main

Run a recipe

# Inline prompt
goose run --text "Add unit tests for foo.py"

# From a recipe file
goose run --recipe code-review.yaml --params branch=main

# From the official cookbook
goose run --recipe https://raw.githubusercontent.com/block/goose/main/cookbook/code-review.yaml

Why use recipes vs raw prompts

Without recipe With recipe
Re-type the prompt every time Run by name
Tool list inconsistent across runs Tool list fixed in the file
No way to share Commit the YAML, share the URL
No parameters --params key=value

FAQ

Q: Is Goose Recipes free? A: Yes. Goose itself is open-source under Apache-2.0 license. Recipes are just YAML files — you only pay for the LLM tokens consumed when you run them.

Q: How does this differ from a slash command? A: Slash commands are interactive prompts you type each time. Recipes are checked-in files with parameters and a fixed extension list, designed for shareable, reproducible runs across machines and teammates.

Q: Where can I find pre-built recipes? A: Block maintains the official cookbook at github.com/block/goose under /cookbook. Each recipe has a title, description, and is runnable via --recipe URL directly.

Quick Use

  1. Save the recipe YAML below to your repo as code-review.yaml
  2. Install Goose: brew install goose-ai/goose/goose (or download from block.github.io/goose)
  3. Run: goose run --recipe code-review.yaml

Intro

Goose Recipes are reusable YAML workflow definitions for Block's Goose agent. Each recipe bundles a prompt, a list of allowed tools, and parameters into a single shareable file you run with goose run --recipe. Best for: teams standardizing repeated agent tasks (code review, dependency audits, release notes). Works with: Goose CLI, Goose Desktop. Setup time: under 2 minutes.

What's in a recipe

A recipe.yaml file defines:

title: Code Review Agent
description: Reviews changes since main branch
prompt: |
  Review all changes since main. Flag bugs, security issues,
  and style violations. Format findings by severity.
extensions:
  - name: developer
  - name: github
parameters:
  - key: branch
    description: Branch to compare against
    default: main

Run a recipe

# Inline prompt
goose run --text "Add unit tests for foo.py"

# From a recipe file
goose run --recipe code-review.yaml --params branch=main

# From the official cookbook
goose run --recipe https://raw.githubusercontent.com/block/goose/main/cookbook/code-review.yaml

Why use recipes vs raw prompts

Without recipe With recipe
Re-type the prompt every time Run by name
Tool list inconsistent across runs Tool list fixed in the file
No way to share Commit the YAML, share the URL
No parameters --params key=value

FAQ

Q: Is Goose Recipes free? A: Yes. Goose itself is open-source under Apache-2.0 license. Recipes are just YAML files — you only pay for the LLM tokens consumed when you run them.

Q: How does this differ from a slash command? A: Slash commands are interactive prompts you type each time. Recipes are checked-in files with parameters and a fixed extension list, designed for shareable, reproducible runs across machines and teammates.

Q: Where can I find pre-built recipes? A: Block maintains the official cookbook at github.com/block/goose under /cookbook. Each recipe has a title, description, and is runnable via --recipe URL directly.

Source & Thanks

Built and maintained by Block. Licensed under Apache-2.0.

block/goose — ⭐ 17,000+

🙏

Source & Thanks

Built and maintained by Block. Licensed under Apache-2.0.

block/goose — ⭐ 17,000+

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Goose — Open-Source AI Dev Agent by Block

Goose is Block's open-source AI agent that automates developer workflows. 33.8K+ stars. Extensible plugins, MCP support, multi-tool orchestration. Apache 2.0.

Skills
Block

Goose — AI Developer Agent by Block

Open-source AI developer agent by Block (Square). Goose automates coding tasks with extensible toolkits, session memory, and MCP server support in your terminal.

Scripts
Block

Mastra Workflows — TypeScript Agent Orchestration

Mastra Workflows defines multi-step typed agent flows in TypeScript. Build pipelines with .then(), .branch(), .parallel(), .while(). End-to-end type-safe.

Workflows
Mastra

Vapi — Voice AI Agent Platform with STT, LLM & TTS

Vapi glues STT, LLM, TTS, turn-taking into one voice agent API. Build phone agents in minutes. Twilio + Deepgram + ElevenLabs + GPT-4o stack.

Workflows
Vapi
◈Home🔍Search👤Me