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

## Install

Copy the content below into your project:

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

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

```bash
# 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](https://github.com/block). Licensed under Apache-2.0.
>
> [block/goose](https://github.com/block/goose) — ⭐ 17,000+

---

<!-- ZH -->

## 快速使用

1. 把下面的 recipe YAML 保存到仓库里命名为 `code-review.yaml`
2. 装 Goose：`brew install goose-ai/goose/goose`（或从 block.github.io/goose 下载）
3. 跑：`goose run --recipe code-review.yaml`

---

## 简介

Goose Recipes 是 Block 公司 Goose agent 的可复用 YAML 工作流定义。每个 recipe 把 prompt、可用工具、参数打成一个文件，用 `goose run --recipe` 一条命令跑。适合团队把重复的 agent 任务（代码审查、依赖审计、发布说明）标准化。兼容 Goose CLI 和 Goose Desktop。装机时间 2 分钟。

---

### Recipe 长什么样

`recipe.yaml` 文件定义：

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

### 跑 recipe

```bash
# 行内 prompt
goose run --text "Add unit tests for foo.py"

# 用 recipe 文件
goose run --recipe code-review.yaml --params branch=main

# 直接用官方 cookbook
goose run --recipe https://raw.githubusercontent.com/block/goose/main/cookbook/code-review.yaml
```

### 为什么用 recipe 而不是裸 prompt

| 不用 recipe | 用 recipe |
|---|---|
| 每次重打 prompt | 按名字跑 |
| 工具清单每次都不一样 | 工具清单固定在文件里 |
| 没法共享 | 提交 YAML，分享 URL |
| 没参数 | `--params key=value` |

---

### FAQ

**Q: Goose Recipes 免费吗？**
A: 免费。Goose 本身 Apache-2.0 开源，Recipes 只是 YAML 文件，你只为执行时消耗的 LLM token 付费。

**Q: 跟 slash 命令有啥区别？**
A: slash 命令每次现打 prompt，是交互式的。Recipe 是带参数和固定扩展清单的入库文件，专门用来跨机器、跨同事复现执行。

**Q: 哪里能找到现成的 recipe？**
A: Block 在 github.com/block/goose 仓库的 /cookbook 目录维护官方合集。每个 recipe 都带 title 和 description，用 `--recipe URL` 直接跑。

---

## 来源与感谢

> Built and maintained by [Block](https://github.com/block). Licensed under Apache-2.0.
>
> [block/goose](https://github.com/block/goose) — ⭐ 17,000+


---
Source: https://tokrepo.com/en/workflows/goose-recipes-reusable-block-goose-agent-workflows
Author: Block