shabbat-times — Claude Code skill: what it does, how to install
Pulls Shabbat times, holidays, the weekly parsha and Hebrew dates from Hebcal, so the agent stops guessing at query parameters.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill shabbat-times -a claude-codeWhat shabbat-times does
The skill hands the agent working request recipes for Hebcal: candle lighting and Havdalah for the coming Shabbat, holiday listings for a year, Gregorian-to-Hebrew date conversion, the weekly parsha. It ships TypeScript snippets for the shabbat, hebcal and converter endpoints, a useShabbatTimes React hook, and a short table of GeoNames IDs for Jerusalem, Tel Aviv, New York, Los Angeles, London and Paris.
Location drives everything. Pass a geonameid, or latitude and longitude. The coordinate sample also sets tzid, and that matters: the timezone rides on the request, so leaving it out returns times on someone else's clock. Add M=on when Havdalah belongs in the reply; without it you get candle lighting and the parsha only.
Calls go straight to https://www.hebcal.com from your app code. The agent gets real parameter names instead of plausible ones. On a React schedule screen that saves a round of corrections.
What it helps with
- show candle lighting and Havdalah for a city
- list Jewish holidays for a given year
- convert a Gregorian date into a Hebrew one
- add the weekly parsha to an app
- wrap the Hebcal calls in a React hook
Example prompts for the agent
- Get candle lighting and Havdalah for New York this week using
geonameid5128581. - Pull the major and minor holidays for 2025 from the
hebcalendpoint. - Turn January 15, 2025 into a Hebrew date with the
converterendpoint.
How to install shabbat-times
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill shabbat-times -a claude-code2Manually: put the files in place
~/.claude/skills/shabbat-times/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/shabbat-times/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill shabbat-times -a codex2Manually: put the files in place
.agents/skills/shabbat-times/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill shabbat-times -a cursor2Manually: put the files in place
.cursor/skills/shabbat-times/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/shabbat-times2Manually: put the files in place
.github/skills/shabbat-times/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill shabbat-times -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/shabbat-timesManually: put the files in place
.devin/skills/shabbat-times/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about shabbat-times
How do I install shabbat-times in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill shabbat-times -a claude-code. The skill file lands at ~/.claude/skills/shabbat-times/SKILL.md.
What does shabbat-times do?
It gives the agent concrete Hebcal request examples for Shabbat times by location, Jewish holidays, date conversion and the weekly parsha, plus a useShabbatTimes React hook.
What do I need to fetch Shabbat times for a city?
A geonameid from GeoNames, or latitude and longitude paired with tzid. Adding M=on brings Havdalah into the response.