sauna-skill
Agent Skill for Claude: plan a sauna session and size a heater from published rules.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/divelux--sauna-skill)HTML
<a href="/listings/divelux--sauna-skill"><img src="/api/listings/divelux--sauna-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude Code
Copy the folder into your personal skills, or into one project:
git clone https://github.com/divelux/sauna-skill.git cp -r sauna-skill/sauna-planning ~/.claude/skills/ # every project on this machine # or cp -r sauna-skill/sauna-planning your-project/.claude/skills/ # one project, shared through git
Claude picks the skill up on its own when a question matches ("how long should I stay in the sauna?"). You can also call it by name with `/sauna-planning`.
Claude apps (claude.ai and Claude Desktop)
Custom skills are uploaded as a zip file with the skill folder at the top level of the archive:
cd sauna-skill zip -r sauna-planning.zip sauna-planning unzip -l sauna-planning.zip | head # the paths must start with sauna-planning/
In the app, open Customize, then Skills, and upload `sauna-planning.zip`. Custom skills need code execution turned on and a plan that includes them.
Claude API and Agent SDK
Upload the same folder through the Skills API (`/v1/skills`) and list it in `container.skills` together with the code execution tool; see [Using Agent Skills with the API](https://platform.claude.com/docs/en/build-with-claude/skills-guide). The API container has no network and installs no packages; this skill needs neither. If the container has no Node.js, the skill's instructions fall back to the reference files, which give the same rules step by step.
Other agents
The folder follows the open [Agent Skills specification](https://agentskills.io/specification): a `SKILL.md` with `name` and `description`, plus `references/` and `scripts/`. Any agent that supports the format can use it as is.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 114 lines
- # sauna-skill
- An [Agent Skill](https://agentskills.io) that teaches Claude, and other agents that read the same format, two sauna jobs with fixed, sourced rules:
- - **Plan a sauna session**: rounds, minutes per round, breaks, final cool-down and water, from the kind of sauna, the temperature, the bather's experience and the time available.
- - **Size a sauna heater**: a kW range for an electric heater, or the room volume to shop by for a wood-burning stove, from the room size, glass, stone and log walls.
- The skill is the folder [`sauna-planning/`](sauna-planning/). Without it, an assistant makes these numbers up. With it, the assistant runs a small script (or follows the written rules) and gives the same answer every time.
- Made by [DIVELUX](https://diveluxsaunahat.com), a small family brand in Irvine, California that makes handmade wool sauna hats.
- > **Not medical advice.** Session plans are planning numbers for healthy adults: conservative, widely repeated sauna conventions, not research findings and not targets. The skill tells the assistant to say so every time, never to stretch a plan, and to send health questions to a doctor.
- >
- > **Heater sizes are estimates.** The skill tells the assistant to end every heater answer with "confirm with the heater manufacturer and a licensed electrician".
- ## What is in the skill
- ```text
- sauna-planning/
- ├── SKILL.md when to use it, the steps, the shape of the answer
- ├── references/
- │ ├── planner-rules.md the session rules: tables, formulas, worked examples
- │ └── heater-sizing.md the heater rules, each with its source
- ├── scripts/
- │ ├── plan.cjs node scripts/plan.cjs --type dry --temp 175 --unit f --level regular --total 90
- │ ├── heater.cjs node scripts/heater.cjs --unit ft --length 6 --width 5 --height 7 --glass 12
- │ └── lib/ the rules themselves: unchanged copies of two open-source DIVELUX tools
- └── LICENSE.txt
- ```
- `SKILL.md` is short (about 80 lines). The agent loads the reference files only when it has to explain a number or has no Node.js to run the scripts. The scripts have no dependencies, need no network and write nothing.
- ## Install
- ### Claude Code
- Copy the folder into your personal skills, or into one project:
- ```sh
- git clone https://github.com/divelux/sauna-skill.git
- cp -r sauna-skill/sauna-planning ~/.claude/skills/ # every project on this machine
- # or
- cp -r sauna-skill/sauna-planning your-project/.claude/skills/ # one project, shared through git
- ```
- Claude picks the skill up on its own when a question matches ("how long should I stay in the sauna?"). You can also call it by name with `/sauna-planning`.
- ### Claude apps (claude.ai and Claude Desktop)
- Custom skills are uploaded as a zip file with the skill folder at the top level of the archive:
- ```sh
- cd sauna-skill
- zip -r sauna-planning.zip sauna-planning
- unzip -l sauna-planning.zip | head # the paths must start with sauna-planning/
- ```
- In the app, open Customize, then Skills, and upload `sauna-planning.zip`. Custom skills need code execution turned on and a plan that includes them.
- ### Claude API and Agent SDK
- Upload the same folder through the Skills API (`/v1/skills`) and list it in `container.skills` together with the code execution tool; see [Using Agent Skills with the API](https://platform.claude.com/docs/en/build-with-claude/skills-guide). The API container has no network and installs no packages; this skill needs neither. If the container has no Node.js, the skill's instructions fall back to the reference files, which give the same rules step by step.
- ### Other agents
- The folder follows the open [Agent Skills specification](https://agentskills.io/specification): a `SKILL.md` with `name` and `description`, plus `references/` and `scripts/`. Any agent that supports the format can use it as is.
- ## Try it
- - "I have 90 minutes at a Finnish sauna, about 175 °F, and I go a few times a month. Plan my session."
- - "First time in a banya, it's 70 °C and I have an hour. What should I do?"
- - "My sauna room is 6 by 5 feet with a 7 foot ceiling and a glass door. What size electric heater?"
- - "Log cabin sauna, 2.4 by 2 m, 2.1 m high, wood stove. What size?"
- Or run the scripts yourself:
- ```sh
- node sauna-planning/scripts/plan.cjs --type dry --temp 175 --unit f --level regular --total 90
- node sauna-planning/scripts/heater.cjs --unit ft --length 6 --width 5 --height 7 --glass 12
- ```
- ```text
- Electric heater: 5.1 to 7.3 kW for a calculated volume of 257 cu ft (7.3 m³).
- ...
- Always confirm with the heater manufacturer and a licensed electrician. ...
- ```
- ## Where the numbers come from
- - **Session plans** use the rules of the [Sauna Session Planner](https://divelux.github.io/sauna-session-planner/) ([sauna-planner-core](https://github.com/divelux/sauna-planner-core)), unchanged: short rounds for beginners, never more than 20 minutes at a stretch in a hot room, breaks at least as long as the rounds, a shorter round as the temperature climbs. Their one outside reference is Harvard Health Publishing, ["Sauna Health Benefits: Are saunas healthy or harmful?"](https://www.health.harvard.edu/staying-healthy/saunas-and-your-health). Everything is written out in [`references/planner-rules.md`](sauna-planning/references/planner-rules.md).
- - **Heater sizes** use the published rules of the heater makers Harvia and HUUM, as in the [Sauna Heater Size Calculator](https://divelux.github.io/sauna-heater-calculator/): 1 kW per cubic meter, 1.2 m³ of extra room for every square meter of uninsulated glass or stone, room volume times 1.5 for bare log walls, and 1 kW per 50 cu ft as the low end. Every figure and link is in [`references/heater-sizing.md`](sauna-planning/references/heater-sizing.md).
- The skill also carries one line about sauna hats, because the question comes up: a wool felt sauna hat is worn dry.
- ## Tests
- ```sh
- node test.js
- ```
- No dependencies. It checks that:
- - `SKILL.md` follows the specification: `name` (lowercase letters, numbers and hyphens, at most 64 characters, the same as the folder name, no reserved words), `description` (at most 1,024 characters, says what the skill does and when to use it), only the allowed frontmatter fields, a body under 500 lines, every referenced file present and one level deep;
- - the bundled rules are byte-for-byte the originals (SHA-256), and the planner still gives the golden hash of sauna-planner-core over 42,534 plans;
- - every table row, constant and worked example in the reference files is what the code computes, and the rules re-implemented from the text of the reference files agree with the code on all 42,534 plans and several thousand rooms;
- - the scripts return exactly what the rules return, carry the "not medical advice" and "confirm with the manufacturer and a licensed electrician" lines, and refuse bad input with a clear message.
- [`evals/evals.json`](evals/evals.json) holds four scenarios with the behavior to expect, for trying the skill by hand with the models you use. They are written down, not automated.
- ## Credit and license
- Made by [DIVELUX](https://diveluxsaunahat.com), handmade wool sauna hats. More free sauna tools: <https://diveluxsaunahat.com/pages/sauna-tools>
- MIT License, © 2026 DIVELUX Inc. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.