Breweries

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

Security Scan

The skill's description and required tools match its brewery-search purpose, but the runtime instructions expect local scripts that are not included and there's no install spec — this mismatch and the implied external git/clone step are concerning.

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.

What to consider before installing

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.

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

1. Run ./breweries search "name" to find by name
2. Run ./breweries city "city" for location-based search
3. Run ./breweries state "state" for state-wide search
4. Run ./breweries type brewpub for specific types
5. 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.