這是一個專為 AI 代理設計的技能集合，旨在協助日本的日常生活。 本技能集僅使用氣象廳公開資料、內閣府國定假日 CSV、カーリル圖書館 API 等官方 API 與公開資料，專注於無需登入即可安全使用的查詢類技能。
適用於 Claude Code、Codex、OpenCode 等支援 npx skills add 的程式碼代理。
功能一覽
「登入」欄僅指出是否需要使用者本人的帳號或密鑰。
| 功能 | 技能名稱 | 說明 | 登入 | 文件 |
|---|---|---|---|---|
| 查詢日本天氣預報 | jma-weather | 從氣象廳公開 JSON 取得天氣、降雨機率、氣溫預報 | 不需要 | jma-weather 指南 |
| 查詢地震速報與氣象警報 | bosai-alert | 取得氣象廳防災資訊（地震列表與詳情、警報・注意報、海嘯資訊） | 不需要 | bosai-alert 指南 |
| 查詢國定假日與連休 | japan-holidays | 從內閣府官方 CSV 計算國定假日、補休、國民假日及連休 | 不需要 | japan-holidays 指南 |
| 估算故鄉稅捐贈上限額 | furusato-nozei | 根據薪資收入或課稅所得估算捐贈上限（無需 API） | 不需要 | furusato-nozei 指南 |
| 搜尋圖書館館藏 | calil-books | 透過カーリル圖書館 API 搜尋館藏與借閱狀況 | 需要免費 API 金鑰 | calil-books 指南 |
每個技能的主要文件為 <技能名稱>/SKILL.md。docs/features/ 下的指南為概述版本，詳細步驟、參數與錯誤處理請務必參閱 SKILL.md。
範圍說明：
- 針對具備強力反爬蟲機制的服務（如 Mercari、SUUMO、乗換案内、食べログ等）不在支援範圍內。
- 不處理預約、購買、投稿等會變更狀態的操作，僅限查詢與計算。
- 氣象與防災資訊直接取得氣象廳發布的原始資料。做出最終判斷前，請務必確認官方發布資訊。
安裝方式
# 安裝所有技能
npx --yes skills add tahodev/kurashi-skill --all -g
# 僅安裝特定技能
npx --yes skills add tahodev/kurashi-skill --skill jma-weather -g
需要 Node.js 18 以上版本與 npx。詳細說明請參閱安裝指南。
30 天公開開發挑戰進行中
此儲存庫正以 30 天公開開發挑戰的形式成長：每天一個技能，每次提交同時也是 Qiita 文章。值得一提的是，共同創作的 AI 代理（Astra）的配額能否撐過 30 天，其實是最大的風險因素。
| Day | 日期 | 事件 |
|---|---|---|
| 1 | 2026-09-09 | 宣言 & 儲存庫公開（初始 5 個技能） |
English
kurashi-skill (暮らし, "kurashi" = everyday life) is a collection of AI-agent skills for daily life in Japan. It focuses on read-only lookups and calculations built only on official APIs and public datasets: no login walls, no scraping.
Works with any coding agent that supports npx skills add (Claude Code, Codex, OpenCode, ...).
What you can do
| What you can do | Skill | Description | Login | Docs |
|---|---|---|---|---|
| Look up weather forecasts in Japan | jma-weather | Weather, precipitation probability and temperature forecasts from the Japan Meteorological Agency's public JSON feeds | Not required | jma-weather guide |
| Look up earthquake bulletins and weather warnings | bosai-alert | JMA disaster information: earthquake list and details, warnings/advisories, tsunami information | Not required | bosai-alert guide |
| Look up national holidays and long weekends | japan-holidays | Holiday, substitute-holiday and bridge-holiday calculation from the Cabinet Office's official CSV | Not required | japan-holidays guide |
| Estimate your furusato nozei donation cap | furusato-nozei | Pure-calculation estimate of the hometown-tax donation limit (no API needed) | Not required | furusato-nozei guide |
| Search library holdings | calil-books | Library and book-availability search via the Calil API | Free API key required | calil-books guide |
The canonical source for each skill is its <skill>/SKILL.md. The guides under docs/features/ are summaries only - always refer to SKILL.md for full procedures, parameters, and error handling.
Scope notes:
- Services with heavy anti-scraping (Mercari, SUUMO, transfer guides, Tabelog, ...) are out of scope.
- Nothing here changes state: no reservations, purchases, or posts. Lookups and calculations only.
- Weather and disaster data are JMA announcements as-is. Always confirm against official JMA bulletins before making decisions.
Install
# Install every skill
npx --yes skills add tahodev/kurashi-skill --all -g
# Install a single skill
npx --yes skills add tahodev/kurashi-skill --skill jma-weather -g
Node.js 18+ and npx are required. See the install guide for details.
Building in public: a 30-day challenge
This repository is growing as a 30-day build-in-public challenge: one skill a day, with each commit doubling as a Qiita article. Frankly, the biggest risk factor is whether the quota of Astra - the AI agent co-authoring this series - survives all 30 days.
| Day | Date | What happened |
|---|---|---|
| 1 | 2026-09-09 | Declaration & repository launch (initial 5 skills) |