일본에서의 생활을 돕는 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를 참조하세요.
범위에 대해:
- 스크래핑 방어가 강한 서비스(메루카리, 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일간의 공개 개발 (build in public) 챌린지 진행 중
이 리포지토리는 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) |