← Back to Skills Marketplace

Breweries

Name: Breweries
Author: jeffaf

by jeffaf · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

1483

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install breweries

Description

CLI for AI agents to find breweries for their humans. Uses Open Brewery DB. No auth required.

README (SKILL.md)

Brewery Lookup

CLI for AI agents to find breweries for their humans. "What breweries are in Portland?" — now your agent can answer.

Uses Open Brewery DB. No account or API key needed.

Usage

"Find breweries named Sierra Nevada"
"What breweries are in San Diego?"
"Show me breweries in Oregon"
"Find me a random brewery"
"What brewpubs are there?"

Commands

Action	Command
Search by name	`breweries search "name"`
Find by city	`breweries city "city name"`
Find by state	`breweries state "state"`
Find by type	`breweries type \x3Ctype>`
Random	`breweries random [count]`

Brewery Types

micro — Most craft breweries
nano — Very small breweries
regional — Regional craft breweries
brewpub — Brewery with restaurant/bar
large — Large national breweries
planning — Breweries in planning
bar — Bars that brew on premises
contract — Contract brewing
proprietor — Alternating proprietor
closed — Closed breweries

Examples

breweries search "stone brewing"    # Find breweries by name
breweries city "portland"           # Find breweries in Portland
breweries state oregon              # Find breweries in Oregon
breweries type brewpub              # Find all brewpubs
breweries random 3                  # Get 3 random breweries

Output

🍺 Sierra Nevada Brewing Co. — Chico, California, Regional Brewery
   https://sierranevada.com

Notes

Uses Open Brewery DB API v1 (api.openbrewerydb.org)
No authentication required
No rate limiting documented
Returns up to 10 results per query
State names can be full name or abbreviation

Agent Implementation Notes

Script location: {skill_folder}/breweries (wrapper) → scripts/breweries

When user asks about breweries:

Run ./breweries search "name" to find by name
Run ./breweries city "city" for location-based search
Run ./breweries state "state" for state-wide search
Run ./breweries type brewpub for specific types
Run ./breweries random for discovery/recommendations

Common patterns:

"Find me a brewery in [city]" → breweries city "[city]"
"What breweries are in [state]?" → breweries state "[state]"
"Search for [name] brewery" → breweries search "[name]"
"Surprise me with a brewery" → breweries random
"Where can I get craft beer in [city]?" → breweries city "[city]" or breweries type micro

Don't use for: Bars without brewing, liquor stores, wine/spirits.

Usage Guidance

This skill appears to be honest about what it does (queries Open Brewery DB) and does not request credentials, but the package is incomplete: SKILL.md/README expect local executables that are not included. Before installing or running it, ask the publisher for the missing scripts or an explicit install spec, and review the code in the referenced GitHub repo yourself. If you must fetch from GitHub, inspect the scripts for unexpected network calls, credential access, or shell commands before making them executable. If you prefer lower risk, install a skill that bundles its code or provides a verified install mechanism in the registry.

Capability Analysis

Type: OpenClaw Skill Name: breweries Version: 1.0.0 The OpenClaw skill 'breweries' is designed to query the Open Brewery DB API. All files (SKILL.md, README.md, _meta.json) consistently describe this purpose. The skill requires `bash`, `curl`, and `jq`, which are appropriate for making HTTP requests and parsing JSON. The SKILL.md instructions for the AI agent are focused solely on using the `breweries` script for its stated purpose, with no evidence of prompt injection attempts to deviate from this, exfiltrate data, or perform other malicious actions. The installation instructions involve a standard `git clone` from a GitHub repository, which is not inherently suspicious.

Capability Assessment

ℹ Purpose & Capability

Name/description, required binaries (bash, curl, jq), and use of Open Brewery DB align with a simple CLI that queries a public API. However, the SKILL.md describes a wrapper script at {skill_folder}/breweries and scripts/breweries that are not present in the package, so the skill as delivered cannot perform the actions it documents without fetching external code.

⚠ Instruction Scope

Instructions direct the agent to run local executable(s) (./breweries and scripts/breweries) and give concrete command examples. The package contains only README.md and SKILL.md — no executables or scripts. That mismatch means following the SKILL.md would either fail or require the agent/user to fetch and run external code, which broadens scope and risk.

⚠ Install Mechanism

There is no install specification in the registry entry. The README suggests cloning a GitHub repo (https://github.com/jeffaf/breweries-skill.git) and running chmod on scripts — an ad-hoc external install. While GitHub is a common host, the registry should include an explicit, reviewable install spec; relying on a separate repo increases risk (implicit network fetch and execution of code not packaged with the skill).

✓ Credentials

The skill requests no environment variables or credentials, and its functionality (querying a public API) does not require secrets. The declared required binaries are appropriate and proportional to the described CLI.

✓ Persistence & Privilege

The skill does not request persistent/always-on installation and uses default model invocation settings. It does not declare access to other skills' configs or system-wide settings.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install breweries
After installation, invoke the skill by name or use /breweries
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

- Initial release of the breweries CLI skill. - Search for breweries by name, city, state, or type using Open Brewery DB. - Supports random brewery suggestions. - No authentication or API key required. - Outputs concise brewery info with name, location, type, and URL. - Requires bash, curl, and jq.

Metadata

Slug breweries

Version 1.0.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Breweries?

CLI for AI agents to find breweries for their humans. Uses Open Brewery DB. No auth required. It is an AI Agent Skill for Claude Code / OpenClaw, with 1483 downloads so far.

How do I install Breweries?

Run "/install breweries" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Breweries free?

Yes, Breweries is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Breweries support?

Breweries is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Breweries?

It is built and maintained by jeffaf (@jeffaf); the current version is v1.0.0.

More Skills