日本の暮らしを、AIエージェントに。
紹介サイト — tahodev.github.io/kurashi-skill
実際の公式データを使ったデモ / Demo using live official data
日本での暮らしを手伝う、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 ガイド |
| 和暦と西暦を変換する | wareki |
元号の境界表で西暦⇄和暦を相互変換(API不要) | 不要 | wareki ガイド |
| 六曜を調べる | rokuyo |
国立天文台の暦要項から作った旧暦テーブルで大安・仏滅などを計算 | 不要 | rokuyo ガイド |
| 郵便番号・住所を検索する | zipcode-lookup |
日本郵便の公式データ(KEN_ALL)で郵便番号⇄住所をローカル検索 | 不要 | zipcode-lookup ガイド |
| 郵便料金を調べる | yubin-fee |
定形・定形外・はがき・レターパックなどの料金を重量とサイズから計算。速達・書留・特定記録の加算とゆうパック運賃(東京発)にも対応 | 不要 | yubin-fee ガイド |
| 今の雨雲を調べる | amagumo |
気象庁の雨雲レーダータイルから現在の雨の強さと短時間の見通しを取得 | 不要 | amagumo ガイド |
| 台風の発生を確認する | bosai-typhoon |
気象庁の台風情報JSONで発生中の台風の有無を確認 | 不要 | bosai-typhoon ガイド |
| 緊急地震速報の発表状況を見る | eew-monitor |
緊急地震速報(EEW)の最新電文と直近の地震・津波情報を公開中継APIから取得 | 不要 | eew-monitor ガイド |
| 政府統計を検索・取得する | estat-stats |
e-Stat API v3で統計表の検索・メタ情報・データ取得 | APIキー(無料)が必要 | estat-stats ガイド |
| ごみ収集日を調べる | garbage-day |
5374形式の公開CSVと自治体公式オープンデータで収集曜日と品目別分別を照会 | 不要 | garbage-day ガイド |
| 公用文の表記を校閲する | koyobun-check |
文化審議会建議「公用文作成の考え方」に基づく表記チェック(API不要) | 不要 | koyobun-check ガイド |
| 火山情報を調べる | volcano |
気象庁の公開JSONから噴火速報・噴火警報・火山解説情報を取得 | 不要 | volcano ガイド |
| 指定避難所を検索する | shelter-lookup |
国土地理院の公式CSVから災害別に最寄り3か所を直線距離順で検索 | 不要 | shelter-lookup ガイド |
| アメダスの現在値を調べる | amedas-weather |
気象庁のアメダス観測JSONから全国約1,300観測所の気温・湿度・風・降水量の最新値を取得 | 不要 | amedas-weather ガイド |
| 大気汚染の現在値を調べる | air-quality |
環境省のAEROS(そらまめくん)からPM2.5・光化学オキシダントなど全国約1,600測定局の速報値を取得 | 不要 | air-quality ガイド |
| 暑さ指数(WBGT)を調べる | heatstroke |
環境省 熱中症予防情報サイトの公式API v1から全国865地点の暑さ指数の予測値・実況値を取得 | 不要 | heatstroke ガイド |
| 住所を分解・正規化する | address-normalize |
デジタル庁アドレス・ベース・レジストリ(ABR)の公式マスタで住所を都道府県・市区町村・町字・番地に分解 | 不要 | address-normalize ガイド |
| 本の書誌を検索する | ndl-books |
国立国会図書館サーチAPIでISBN・タイトル・著者名から書誌を検索 | 不要 | ndl-books ガイド |
| 青空文庫の本文を読む | aozora |
全作品カタログCSVで作品検索、本文をプレーンテキスト取得(ルビ除去) | 不要 | aozora ガイド |
| 国会で何が言われたか調べる | kokkai |
国会会議録検索APIで議事録を発言単位・会議単位で検索 | 不要 | kokkai ガイド |
| 法律の条文を条番号で引く | egov-laws |
e-Gov法令API v2で法令検索・条文取得・時点指定・改正履歴・全文検索 | 不要 | egov-laws ガイド |
| 給与の源泉所得税(月額表)を計算する | withholding-tax |
国税庁の特例計算式で月給と扶養人数から源泉徴収税額の目安を算出。令和8年分/令和9年分(API不要) | 不要 | withholding-tax ガイド |
| 住所から緯度経度・標高を調べる、緯度経度から住所を調べる | gsi-geocode |
国土地理院の住所検索・標高・逆ジオコーダAPIを使う。曖昧一致の先頭が正解とは限らない点まで扱う | 不要 | gsi-geocode ガイド |
各スキルの正本は <スキル名>/SKILL.md です。docs/features/ のガイドは概要版なので、詳細な手順・パラメータ・エラー対応は必ず SKILL.md を参照してください。
スコープについて:
- スクレイピング対策が強いサービス(メルカリ、SUUMO、乗換案内、食べログなど)は対象外です。
- 予約・購入・投稿など状態を変更する操作は扱いません。照会と計算だけです。
- 気象・防災情報は気象庁の発表データをそのまま取得します。最終的な判断には必ず公式発表を確認してください。
# すべてのスキルをインストール
npx --yes skills add tahodev/kurashi-skill --all -g
# 特定のスキルだけインストール
npx --yes skills add tahodev/kurashi-skill --skill jma-weather -gNode.js 18 以上と npx が必要です。10個の lookup.py ヘルパーには Python 3.10 以上が必要です。詳しくは インストールガイド を参照してください。
目的別のおすすめセットと代表質問は スターターガイド にまとめています。
- 生活基本パック — 天気・雨雲・祝日・ごみ収集日・郵便番号・郵便料金
- 防災パック — 地震速報・警報・台風・火山・避難所
- 行政・文書パック — ふるさと納税・和暦・六曜・公用文校閲
- データ調査パック — e-Stat統計・図書館蔵書 (このパックのみ無料キーあり)
Qiitaの30日連載は2026-10-10に完了しました。Day 30 総括では27スキルの検証範囲と今後の課題をまとめています。現在は公開APIへの追従・固定データの更新・使い方の改善を続けます。
以下のDayは開発ログの区分です。Qiita連載のDay番号とは異なります。公開記事の順番は連載側を参照してください。 現在の収録数: 27スキル (2026-10-05, v1.0.0)。Day 3以降の追加・変更履歴は、重複によるずれを防ぐため CHANGELOG.md を正本とします。
| Day | 日付 | できごと |
|---|---|---|
| 1 | 2026-09-09 | 宣言 & リポジトリ公開 (初期スキル5個) |
| 2 | 2026-09-10 | jma-weather v2 アップグレード |
| 3-7 | 2026-09-11 | 初期スキルの強化、CI(health-check)整備、ROADMAP策定、ライブデモGIF追加 |
| 8-13 | 2026-09-11 | 新スキル6個追加 (wareki / rokuyo / zipcode-lookup / yubin-fee / amagumo / bosai-typhoon) |
| 14 | 2026-09-13 | 新スキル4個追加 (eew-monitor / estat-stats / garbage-day / koyobun-check) |
| 15 | 2026-09-19 | volcano 追加 (気象庁 火山JSON) |
| 16 | 2026-09-19 | shelter-lookup 追加 (国土地理院 避難所データ) |
| 17 | 2026-09-20 | amedas-weather 追加 (気象庁 アメダス観測JSON) |
| 18 | 2026-09-26 | air-quality 追加 (環境省 AEROS/そらまめくん) |
| 19 | 2026-09-26 | heatstroke 追加 (環境省 暑さ指数API v1) |
| 20 | 2026-09-26 | address-normalize 追加 (デジタル庁 ABRマスタ) |
| 21 | 2026-09-29 | ndl-books 追加 (国立国会図書館サーチAPI) |
| 22 | 2026-09-30 | aozora 追加 (青空文庫 カタログCSV) |
| 23 | 2026-10-01 | kokkai 追加 (国会会議録検索API) |
| 24 | 2026-10-02 | egov-laws 追加 (e-Gov法令API v2) |
| 25 | 2026-10-03 | withholding-tax 追加 (源泉徴収税額の目安計算) |
| 26 | 2026-10-04 | gsi-geocode 追加 (国土地理院 住所検索・標高・逆ジオコーダ) |
| 27 | 2026-10-05 | v1.0.0 リリース (27スキルの最終点検。URL出現 OK 112・FAIL 0) |
今後の候補は ROADMAP.md を参照。
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 | 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 |
| Convert between Gregorian and Japanese era dates | wareki |
Day-exact era boundary table for wareki conversion (no API) | Not required | wareki guide |
| Check the rokuyo fortune day | rokuyo |
Taian/butsumetsu and the other four from a lunar table built on the official almanac | Not required | rokuyo guide |
| Look up postal codes and addresses | zipcode-lookup |
Two-way search over Japan Post's official KEN_ALL dataset | Not required | zipcode-lookup guide |
| Check domestic postage fees | yubin-fee |
Letter, postcard and Letter Pack fees from weight and size (2024-10-01 revision), plus express/registered/tokutei-kiroku surcharges and Yu-Pack fares (from Tokyo) | Not required | yubin-fee guide |
| Check current rain radar | amagumo |
JMA rain-cloud tiles for current intensity and a 30-60 minute outlook | Not required | amagumo guide |
| Check for active typhoons | bosai-typhoon |
JMA typhoon JSON feed; a 404 means none active (normal) | Not required | bosai-typhoon guide |
| Check live earthquake early warnings | eew-monitor |
Latest EEW telegram and recent quake/tsunami bulletins via public relay APIs | Not required | eew-monitor guide |
| Search and fetch government statistics | estat-stats |
Table search, metadata and data retrieval via the official e-Stat API v3 | Free API key required | estat-stats guide |
| Look up garbage collection days | garbage-day |
Per-district collection weekdays and item-level sorting rules from 5374-format open CSVs and official municipal open data | Not required | garbage-day guide |
| Proofread administrative Japanese | koyobun-check |
Style checks based on the 2022 koyobun recommendation (no API) | Not required | koyobun-check guide |
| Check volcano bulletins | volcano |
Eruption notices, warnings and explanatory bulletins from JMA public JSON | Not required | volcano guide |
| Search designated shelters | shelter-lookup |
Find the nearest three official GSI evacuation sites by hazard and straight-line distance | Not required | shelter-lookup guide |
| Check current AMeDAS observations | amedas-weather |
Latest temperature, humidity, wind and precipitation from about 1,300 JMA observation stations | Not required | amedas-weather guide |
| Check current air pollution levels | air-quality |
Hourly PM2.5, oxidant and other readings from about 1,600 monitoring stations via the Ministry of the Environment's AEROS (Soramame) | Not required | air-quality guide |
| Check the heat index (WBGT) | heatstroke |
Forecast and observed WBGT for 865 points from the Ministry of the Environment's heatstroke prevention API v1 | Not required | heatstroke guide |
| Parse and normalize Japanese addresses | address-normalize |
Split an address into prefecture, city, town and lot number using the Digital Agency's Address Base Registry masters | Not required | address-normalize guide |
| Search book bibliographic records | ndl-books |
Bibliographic search by ISBN, title or author via the National Diet Library Search API | Not required | ndl-books guide |
| Read Aozora Bunko texts | aozora |
Search the full-catalog CSV and extract plain text (ruby stripped) | Not required | aozora guide |
| Search Diet proceedings | kokkai |
Search the National Diet record API by speech, meeting or speaker | Not required | kokkai guide |
| Look up statute articles | egov-laws |
Search laws, fetch articles by number, point-in-time text and revision history via the e-Gov Law API v2 | Not required | egov-laws guide |
| Estimate monthly income-tax withholding | withholding-tax |
Compute withholding from monthly pay and dependents with the NTA formula, Reiwa 8 and Reiwa 9 tables (no API needed) | Not required | withholding-tax guide |
| Geocode an address, get elevation, or reverse-geocode | gsi-geocode |
Uses the GSI address-search, elevation and reverse-geocoder APIs; covers unranked fuzzy matches and silent no-data responses | Not required | gsi-geocode 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.
- Common response contract - consistent target, data time, query time, official status, and uncertainty fields
- Combined life scenarios - safe multi-skill flows for going out today and disaster preparation
# 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 -gNode.js 18+ and npx are required. The 10 lookup.py helpers need Python 3.10+. See the install guide for details.
Recommended packs by purpose and ten ready-to-ask sample questions are in the starter guide (Japanese; English summary included).
- Daily-life basics - weather, rain radar, holidays, garbage days, postal codes, postage
- Disaster readiness - earthquake bulletins, warnings, typhoons, volcanoes, shelters
- Admin & documents - furusato nozei, wareki, rokuyo, administrative proofreading
- Data research - e-Stat statistics and library holdings (the only pack with free API keys)
The 30-post Qiita series finished on 2026-10-10. Day 30 recap describes the 27 skills and their limits. Maintenance now focuses on API changes, data updates and practical guides.
The Day labels below group development work; they are not the Qiita article numbering. Current collection: 27 skills (2026-10-05, v1.0.0). To prevent duplicated records from drifting, CHANGELOG.md is the canonical record for additions and changes from Day 3 onward.
| Day | Date | What happened |
|---|---|---|
| 1 | 2026-09-09 | Declaration & repository launch (initial 5 skills) |
| 2 | 2026-09-10 | jma-weather v2 upgrade |
| 3-7 | 2026-09-11 | Strengthened the initial skills, set up CI (health-check), planned the roadmap, and added a live demo GIF |
| 8-13 | 2026-09-11 | Added six skills (wareki / rokuyo / zipcode-lookup / yubin-fee / amagumo / bosai-typhoon) |
| 14 | 2026-09-13 | Added four skills (eew-monitor / estat-stats / garbage-day / koyobun-check) |
| 15 | 2026-09-19 | Added volcano (JMA volcano JSON) |
| 16 | 2026-09-19 | Added shelter-lookup (GSI evacuation-site data) |
| 17 | 2026-09-20 | Added amedas-weather (JMA AMeDAS observation JSON) |
| 18 | 2026-09-26 | Added air-quality (Ministry of the Environment AEROS / Soramame) |
| 19 | 2026-09-26 | Added heatstroke (Ministry of the Environment heat-index API v1) |
| 20 | 2026-09-26 | Added address-normalize (Digital Agency ABR masters) |
| 21 | 2026-09-29 | Added ndl-books (NDL bibliographic search) |
| 22 | 2026-09-30 | Added aozora (catalog and text lookup) |
| 23 | 2026-10-01 | Added kokkai (Diet proceedings) |
| 24 | 2026-10-02 | Added egov-laws (Law API v2) |
| 25 | 2026-10-03 | Added withholding-tax (monthly withholding estimate) |
| 26 | 2026-10-04 | Added gsi-geocode (address, elevation, reverse geocoding) |
| 27 | 2026-10-05 | v1.0.0 final checks and release |
See ROADMAP.md for future candidates.