Collection de compétences pour agents IA destinée à faciliter la vie quotidienne au Japon. Elle regroupe des compétences de consultation utilisant uniquement des API officielles et des données publiques (données ouvertes de l'Agence météorologique du Japon, fichier CSV des jours fériés du Cabinet Office, API des bibliothèques Calil) – sans connexion utilisateur.
Fonctionne avec Claude Code, Codex, OpenCode et tout agent de codage supportant npx skills add.
Ce que vous pouvez faire
La colonne « Connexion » indique uniquement si un compte personnel ou une clé secrète est nécessaire.
| Ce que vous pouvez faire | Nom de la compétence | Description | Connexion | Documentation |
|---|---|---|---|---|
| Consulter les prévisions météo au Japon | jma-weather | Récupère les prévisions météo, probabilité de précipitations et températures depuis les flux JSON publics de l'Agence météorologique | Non requise | Guide jma-weather |
| Consulter les alertes sismiques et météo | bosai-alert | Récupère les informations de l'Agence météorologique (liste et détails des séismes, alertes et avis, informations sur les tsunamis) | Non requise | Guide bosai-alert |
| Consulter les jours fériés et ponts | japan-holidays | Calcule les jours fériés, jours de report et ponts à partir du CSV officiel du Cabinet Office | Non requise | Guide japan-holidays |
| Estimer le plafond de don pour furusato nozei | furusato-nozei | Calcule une estimation du plafond de don pour la taxe communale (sans API) | Non requise | Guide furusato-nozei |
| Rechercher des livres en bibliothèque | calil-books | Recherche les collections et disponibilités via l'API Calil | Clé API gratuite requise | Guide calil-books |
La source officielle de chaque compétence est le fichier <nom_compétence>/SKILL.md. Les guides dans docs/features/ sont des résumés – pour les procédures détaillées, les paramètres et la gestion des erreurs, référez-vous toujours au SKILL.md.
Périmètre :
- Les services fortement protégés contre le scraping (Mercari, SUUMO, plans de transport, Tabelog, etc.) sont exclus.
- Aucune opération modifiant l'état (réservation, achat, publication) n'est traitée. Seules des consultations et des calculs.
- Les données météo et de catastrophes sont directement issues des annonces de l'Agence météorologique. Pour toute décision finale, veuillez consulter les annonces officielles.
Installation
# Installer toutes les compétences
npx --yes skills add tahodev/kurashi-skill --all -g
# Installer une compétence spécifique
npx --yes skills add tahodev/kurashi-skill --skill jma-weather -g
Node.js 18 ou supérieur et npx sont requis. Consultez le guide d'installation pour plus de détails.
Défi de développement en public sur 30 jours en cours
Ce dépôt se développe dans le cadre d'un défi de développement en public sur 30 jours : une compétence par jour, chaque commit faisant office d'article Qiita. À vrai dire, le principal facteur de risque est de savoir si le quota d'Astra – l'agent IA co-auteur de cette série – tiendra les 30 jours.
| Jour | Date | Événement |
|---|---|---|
| 1 | 2026-09-09 | Déclaration et publication du dépôt (5 compétences initiales) |
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) |