Skip to content
Back to search

sauna-skill

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/divelux--sauna-skill/badge.svg)](/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

i

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
  1. # sauna-skill
  2. An [Agent Skill](https://agentskills.io) that teaches Claude, and other agents that read the same format, two sauna jobs with fixed, sourced rules:
  3. - **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.
  4. - **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.
  5. 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.
  6. Made by [DIVELUX](https://diveluxsaunahat.com), a small family brand in Irvine, California that makes handmade wool sauna hats.
  7. > **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.
  8. >
  9. > **Heater sizes are estimates.** The skill tells the assistant to end every heater answer with "confirm with the heater manufacturer and a licensed electrician".
  10. ## What is in the skill
  11. ```text
  12. sauna-planning/
  13. ├── SKILL.md when to use it, the steps, the shape of the answer
  14. ├── references/
  15. │ ├── planner-rules.md the session rules: tables, formulas, worked examples
  16. │ └── heater-sizing.md the heater rules, each with its source
  17. ├── scripts/
  18. │ ├── plan.cjs node scripts/plan.cjs --type dry --temp 175 --unit f --level regular --total 90
  19. │ ├── heater.cjs node scripts/heater.cjs --unit ft --length 6 --width 5 --height 7 --glass 12
  20. │ └── lib/ the rules themselves: unchanged copies of two open-source DIVELUX tools
  21. └── LICENSE.txt
  22. ```
  23. `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.
  24. ## Install
  25. ### Claude Code
  26. Copy the folder into your personal skills, or into one project:
  27. ```sh
  28. git clone https://github.com/divelux/sauna-skill.git
  29. cp -r sauna-skill/sauna-planning ~/.claude/skills/ # every project on this machine
  30. # or
  31. cp -r sauna-skill/sauna-planning your-project/.claude/skills/ # one project, shared through git
  32. ```
  33. 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`.
  34. ### Claude apps (claude.ai and Claude Desktop)
  35. Custom skills are uploaded as a zip file with the skill folder at the top level of the archive:
  36. ```sh
  37. cd sauna-skill
  38. zip -r sauna-planning.zip sauna-planning
  39. unzip -l sauna-planning.zip | head # the paths must start with sauna-planning/
  40. ```
  41. 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.
  42. ### Claude API and Agent SDK
  43. 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.
  44. ### Other agents
  45. 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.
  46. ## Try it
  47. - "I have 90 minutes at a Finnish sauna, about 175 °F, and I go a few times a month. Plan my session."
  48. - "First time in a banya, it's 70 °C and I have an hour. What should I do?"
  49. - "My sauna room is 6 by 5 feet with a 7 foot ceiling and a glass door. What size electric heater?"
  50. - "Log cabin sauna, 2.4 by 2 m, 2.1 m high, wood stove. What size?"
  51. Or run the scripts yourself:
  52. ```sh
  53. node sauna-planning/scripts/plan.cjs --type dry --temp 175 --unit f --level regular --total 90
  54. node sauna-planning/scripts/heater.cjs --unit ft --length 6 --width 5 --height 7 --glass 12
  55. ```
  56. ```text
  57. Electric heater: 5.1 to 7.3 kW for a calculated volume of 257 cu ft (7.3 m³).
  58. ...
  59. Always confirm with the heater manufacturer and a licensed electrician. ...
  60. ```
  61. ## Where the numbers come from
  62. - **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).
  63. - **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).
  64. The skill also carries one line about sauna hats, because the question comes up: a wool felt sauna hat is worn dry.
  65. ## Tests
  66. ```sh
  67. node test.js
  68. ```
  69. No dependencies. It checks that:
  70. - `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;
  71. - 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;
  72. - 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;
  73. - 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.
  74. [`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.
  75. ## Credit and license
  76. Made by [DIVELUX](https://diveluxsaunahat.com), handmade wool sauna hats. More free sauna tools: <https://diveluxsaunahat.com/pages/sauna-tools>
  77. MIT License, © 2026 DIVELUX Inc. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.