Espresso Coffee Brewer Scale Calculator skill for Claude and Codex
Turns a target yield and bean choice into a dialled-in espresso recipe in grams, with grind, temperature and shot time, so each shot lands where you aim.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a barista or home brewer needs coffee dose, water weight, grind and shot time worked out from a target espresso yield and ratio. Do not use for scheduling a brew session or choosing between coffee beans. Related topics: Food, espresso.
What it will ask you for
- Desired espresso yield in ml (number from 20 to 60)
- Preferred brew ratio coffee to water (choose one: 1:1.5, 1:2, 1:2.5, 1:3)
- Coffee bean type (choose one: Arabica, Robusta, Blend)
- Roast level (choose one: Light, Medium, Dark)
- Current grinder setting (free text, e.g. "5 to 10 or a dial number")
- Target extraction time in seconds (number from 20 to 35)
- Water temperature in C (number from 88 to 96)
How it works
- Convert the target yield in ml to grams of espresso and divide by the chosen ratio so the coffee dose is a single stated number.
- Adjust grind direction and water temperature for the bean type and roast so light and dark roasts get different settings.
- Check the target extraction time against the ratio and note which way to move the grinder if the shot runs fast or slow.
- Put dose, water, ratio, grind, temperature and time into one table row and add a one-sentence rationale.
What you get
A markdown table with columns Coffee (g), Water (g), Ratio, Grind, Temp (C), Time (s), followed by a one-sentence rationale for the chosen values.
What it watches out for
- Treating ml of espresso as grams of water in, when the cup yield includes crema and the water in is heavier than the liquid out.
- Giving a grind number without saying which way to move it, so the barista cannot correct a fast or slow shot.
- Using the same temperature for light and dark roasts, which over-extracts dark beans.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.