Skip to content

Instantly share code, notes, and snippets.

@mootrichard
Created October 10, 2025 00:21
Show Gist options
  • Save mootrichard/8a2e4bf200e750f54bebfc78bbe4601f to your computer and use it in GitHub Desktop.
Save mootrichard/8a2e4bf200e750f54bebfc78bbe4601f to your computer and use it in GitHub Desktop.
Goose Subagents Recipe Collection - Complete catalog with usage examples and workflow patterns

Goose Subagents Recipe Collection

A curated collection of powerful Goose recipes for code analysis, testing, documentation, and research.

πŸ“š About

These recipes are specialized configurations for Goose subagents that help automate common development workflows. Each recipe is designed to be reusable, parameterized, and production-ready.

πŸš€ Quick Start

Installation

Download individual recipes:

# Code Review Assistant
curl -o code-reviewer.yaml https://gist.githubusercontent.com/mootrichard/5a31b9cc64b77f1ae55e502daca4d4a0/raw/code-reviewer.yaml

# Test Generator
curl -o test-generator.yaml https://gist.githubusercontent.com/mootrichard/0a78f04c38930936864595d92e23dd57/raw/test-generator.yaml

# Documentation Writer
curl -o doc-writer.yaml https://gist.githubusercontent.com/mootrichard/3ac5e9ead0ca120acaf7df8d542abbe9/raw/doc-writer.yaml

# Codebase Analyzer
curl -o codebase-analyzer.yaml https://gist.githubusercontent.com/mootrichard/9628d286a5c15154535357e3ceb0e40f/raw/codebase-analyzer.yaml

# Codebase Locator
curl -o codebase-locator.yaml https://gist.githubusercontent.com/mootrichard/8399b904ac301c643968cc8835163c35/raw/codebase-locator.yaml

# Web Researcher
curl -o web-researcher.yaml https://gist.githubusercontent.com/mootrichard/d7840a2d498fcdad67656c25dc9e88a3/raw/web-researcher.yaml

Setup Recipe Path

# Create a recipes directory
mkdir -p ~/.goose/recipes

# Move recipes to the directory
mv *.yaml ~/.goose/recipes/

# Set the recipe path
export GOOSE_RECIPE_PATH=~/.goose/recipes

πŸ“‹ Recipe Catalog

Basic Recipes

1. Code Review Assistant

Gist: https://gist.github.com/mootrichard/5a31b9cc64b77f1ae55e502daca4d4a0

Analyzes code quality, security vulnerabilities, performance issues, and best practices adherence.

Parameters:

  • focus_area (optional): security, performance, readability, general

Usage:

Use the "code-reviewer" recipe with focus_area="security" on auth.py

Perfect for:

  • Pre-commit code reviews
  • Security audits
  • Performance optimization
  • Code quality checks

2. Test Generator

Gist: https://gist.github.com/mootrichard/0a78f04c38930936864595d92e23dd57

Generates comprehensive test suites with happy paths, edge cases, and error conditions.

Parameters:

  • test_framework (optional): pytest, jest, junit, mocha, etc.
  • coverage_level (optional): basic, comprehensive, exhaustive

Usage:

Use the "test-generator" recipe with test_framework="jest" and coverage_level="comprehensive" on calculator.js

Perfect for:

  • Creating test suites for new code
  • Improving test coverage
  • Generating regression tests
  • TDD workflows

3. Documentation Writer

Gist: https://gist.github.com/mootrichard/3ac5e9ead0ca120acaf7df8d542abbe9

Creates clear, comprehensive technical documentation with examples and best practices.

Parameters:

  • doc_type (optional): api, guide, tutorial, reference
  • audience (optional): beginner, intermediate, advanced

Usage:

Use the "doc-writer" recipe with doc_type="api" and audience="beginner" for the API module

Perfect for:

  • API documentation
  • User guides
  • Technical tutorials
  • README generation

Advanced Recipes

4. Codebase Implementation Analyzer

Gist: https://gist.github.com/mootrichard/9628d286a5c15154535357e3ceb0e40f

Deep analysis of code implementation with surgical precision, tracing data flow and providing exact file:line references.

Parameters:

  • focus_area (optional): data-flow, architecture, implementation, patterns
  • component (optional): specific component/feature name

Usage:

Use the "codebase-analyzer" recipe to analyze how our authentication system works

Perfect for:

  • Understanding complex code flows
  • Tracing data transformations
  • Architecture analysis
  • Onboarding to new codebases

5. Codebase File Locator

Gist: https://gist.github.com/mootrichard/8399b904ac301c643968cc8835163c35

Locates all files and components related to specific features, organized by purpose.

Parameters:

  • feature (required): feature or functionality to locate
  • file_types (optional): implementation, tests, config, all

Usage:

Use the "codebase-locator" recipe to find all files related to user authentication

Perfect for:

  • Starting work on unfamiliar features
  • Finding related test files
  • Understanding project structure
  • Code navigation

6. Web Research Specialist

Gist: https://gist.github.com/mootrichard/d7840a2d498fcdad67656c25dc9e88a3

Finds current documentation, best practices, and solutions from web sources with proper citations.

Parameters:

  • topic (required): topic or question to research
  • source_type (optional): documentation, tutorials, solutions, comparisons

Usage:

Use the "web-researcher" recipe to find the latest best practices for React hooks

Perfect for:

  • Researching new technologies
  • Finding current documentation
  • Troubleshooting specific errors
  • Comparing approaches

πŸ”₯ Common Workflow Patterns

Feature Development Pipeline

In parallel:
- Use "codebase-locator" to find existing related files
- Use "web-researcher" to find best practices
- Use "codebase-analyzer" to understand current implementation

Then:
- Use "test-generator" to create test suite
- Use "doc-writer" to document the feature

Code Quality Audit

Run in parallel:
- Use "code-reviewer" with focus_area="security"
- Use "code-reviewer" with focus_area="performance"
- Use "code-reviewer" with focus_area="readability"

Bug Investigation

First use "codebase-analyzer" to trace data flow,
then use "codebase-locator" to find related test files,
finally use "test-generator" to create regression tests

Documentation Sprint

For each major component in parallel:
- Use "codebase-analyzer" to understand implementation
- Use "doc-writer" with doc_type="api" for API docs
- Use "doc-writer" with doc_type="guide" for usage guides

🎯 Best Practices

  1. Start Simple: Use direct prompts first, create recipes for repeated tasks
  2. Parallel Execution: Run independent tasks simultaneously for speed
  3. Clear Parameters: Use recipe parameters to make them flexible
  4. Version Control: Track your custom recipes in git
  5. Build a Library: Organize recipes by category (analysis, generation, etc.)

πŸ“– Learn More


🀝 Contributing

Have a useful recipe? Share it with the community!

  1. Create a gist with your recipe
  2. Add clear documentation and examples
  3. Tag it with goose-recipe

πŸ“ License

These recipes are provided as educational examples. Feel free to use, modify, and share them.


Created from the Goose Subagents Workshop Learn to build powerful AI workflows with Goose

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment