Setup
If ~/japan/ doesn't exist or is empty, read setup.md and start naturally.
When to Use
User planning a trip to Japan or asking for local insights: what to prioritize, where to base, what to skip, and how to handle transport, seasonality, and budgeting.
Architecture
Memory lives in ~/japan/. See memory-template.md for structure.
~/japan/
└── memory.md # Trip context
Quick Reference
| Topic |
File |
| Cities and Regions |
|
| Tokyo complete guide |
tokyo.md |
| Kyoto complete guide |
kyoto.md |
| Osaka complete guide |
osaka.md |
| Hiroshima and Miyajima complete guide |
hiroshima-miyajima.md |
| Planning |
|
| Sample itineraries |
itineraries.md |
| Where to stay by style |
accommodation.md |
| Useful apps |
apps.md |
| Food and Drink |
|
| Regional dishes and restaurant strategy |
food-guide.md |
| Wine, sake, and whisky context |
wine.md |
| Experiences |
|
| Signature experiences |
experiences.md |
| Beaches and island stops |
beaches.md |
| Hikes and mountain safety |
hiking.md |
| Nightlife by city |
nightlife.md |
| Reference |
|
| Regions and route differences |
regions.md |
| Culture, etiquette, expectations |
culture.md |
| Traveling with children |
with-kids.md |
| Practical |
|
| Intercity transport and passes |
transport.md |
| Phone and internet |
telecoms.md |
| Emergencies and safety |
emergencies.md |
Core Rules
1. Specific Over Generic
Do not say "do Tokyo highlights." Say "start Asakusa or Meiji-area mornings early, reserve one flagship dinner, then shift to neighborhood-level bars away from the busiest crossing zones."
2. Local Perspective
What locals and repeat travelers actually do, not brochure advice:
- One-night city hopping across long rail legs drains trip quality fast
- Major icon spots are best early or late, not peak midday
- Convenience-store meals are useful but should not replace regional food planning
- Small etiquette misses are avoidable with simple behavior adjustments
3. Regional Differences
| Region |
Key difference |
| Tokyo and Kanto |
Dense urban options, best transit depth, high reservation pressure |
| Kyoto and Nara corridor |
Heritage sites, temple density, stronger seasonality crowds |
| Osaka and Kansai |
Food-first pace, lively nightlife, practical city value |
| Hiroshima and western Honshu |
History focus plus island routes and calmer rhythm |
| Hokkaido |
Nature, seafood, winter sports, wider distance logistics |
| Okinawa |
Subtropical islands, beaches, distinct local culture |
4. Timing is Everything
- Cherry blossom and autumn foliage periods require early booking
- Golden Week and New Year windows can reshape transport availability
- Summer heat and humidity require slower daytime pacing
- Winter can be excellent for cities and snow regions with logistics planning
- Temple and museum quality improves with early start windows
5. Flag Tourist Traps
Be explicit about what to avoid:
- Eating only in landmark-adjacent strips with long lines and weak value
- Attempting Tokyo, Kyoto, Osaka, and Hiroshima in one short trip without buffer
- Buying rail passes without route math
- Stacking long transit day plus heavy nightlife and early temple start
6. Match Trip Style
| Traveler |
Focus on |
| Foodie |
food-guide.md, osaka.md, tokyo.md |
| Culture and temples |
kyoto.md, regions.md, culture.md |
| City and nightlife |
tokyo.md, osaka.md, nightlife.md |
| Family |
with-kids.md, accommodation.md, itineraries.md |
| Nature and hiking |
hiking.md, experiences.md, regions.md |
| Mixed route trip |
itineraries.md, transport.md, regions.md |
Common Traps
- Treating Japan as one compact destination with no transfer cost.
- Choosing too many bases for short trips.
- Ignoring restaurant and experience reservation timing.
- Underestimating summer heat and seasonal weather shifts.
- Not checking if a rail pass actually saves money on planned legs.
- Assuming etiquette is the same as other major destinations.
Security & Privacy
Data that stays local: Trip preferences in ~/japan/
This skill does NOT: Access files outside ~/japan/ or make network requests.
Related Skills
Install with clawhub install <slug> if user confirms:
travel — General trip planning and itinerary structuring
food — Deeper restaurant and cuisine recommendations
japanese — Language support for local communication and signage
english — Backup communication support for multilingual travel
Feedback
- If useful:
clawhub star japan
- Stay updated:
clawhub sync
1---2name: japan3description: Discover Japan like a local with concrete city tips, regional route planning, food context, and practical travel logistics.4---5
6## Setup
7
8If `~/japan/` doesn't exist or is empty, read `setup.md` and start naturally.
9
10## When to Use
11
12User planning a trip to Japan or asking for local insights: what to prioritize, where to base, what to skip, and how to handle transport, seasonality, and budgeting.
13
14## Architecture
15
16Memory lives in `~/japan/`. See `memory-template.md` for structure.
17
18```
19~/japan/
20└── memory.md # Trip context
21```
22
23## Quick Reference
24
25| Topic | File |
26|-------|------|
27| **Cities and Regions** | |
28| Tokyo complete guide | `tokyo.md` |
29| Kyoto complete guide | `kyoto.md` |
30| Osaka complete guide | `osaka.md` |
31| Hiroshima and Miyajima complete guide | `hiroshima-miyajima.md` |
32| **Planning** | |
33| Sample itineraries | `itineraries.md` |
34| Where to stay by style | `accommodation.md` |
35| Useful apps | `apps.md` |
36| **Food and Drink** | |
37| Regional dishes and restaurant strategy | `food-guide.md` |
38| Wine, sake, and whisky context | `wine.md` |
39| **Experiences** | |
40| Signature experiences | `experiences.md` |
41| Beaches and island stops | `beaches.md` |
42| Hikes and mountain safety | `hiking.md` |
43| Nightlife by city | `nightlife.md` |
44| **Reference** | |
45| Regions and route differences | `regions.md` |
46| Culture, etiquette, expectations | `culture.md` |
47| Traveling with children | `with-kids.md` |
48| **Practical** | |
49| Intercity transport and passes | `transport.md` |
50| Phone and internet | `telecoms.md` |
51| Emergencies and safety | `emergencies.md` |
52
53## Core Rules
54
55### 1. Specific Over Generic
56Do not say "do Tokyo highlights." Say "start Asakusa or Meiji-area mornings early, reserve one flagship dinner, then shift to neighborhood-level bars away from the busiest crossing zones."
57
58### 2. Local Perspective
59What locals and repeat travelers actually do, not brochure advice:
60- One-night city hopping across long rail legs drains trip quality fast
61- Major icon spots are best early or late, not peak midday
62- Convenience-store meals are useful but should not replace regional food planning
63- Small etiquette misses are avoidable with simple behavior adjustments
64
65### 3. Regional Differences
66
67| Region | Key difference |
68|--------|----------------|
69| Tokyo and Kanto | Dense urban options, best transit depth, high reservation pressure |
70| Kyoto and Nara corridor | Heritage sites, temple density, stronger seasonality crowds |
71| Osaka and Kansai | Food-first pace, lively nightlife, practical city value |
72| Hiroshima and western Honshu | History focus plus island routes and calmer rhythm |
73| Hokkaido | Nature, seafood, winter sports, wider distance logistics |
74| Okinawa | Subtropical islands, beaches, distinct local culture |
75
76### 4. Timing is Everything
77- Cherry blossom and autumn foliage periods require early booking
78- Golden Week and New Year windows can reshape transport availability
79- Summer heat and humidity require slower daytime pacing
80- Winter can be excellent for cities and snow regions with logistics planning
81- Temple and museum quality improves with early start windows
82
83### 5. Flag Tourist Traps
84Be explicit about what to avoid:
85- Eating only in landmark-adjacent strips with long lines and weak value
86- Attempting Tokyo, Kyoto, Osaka, and Hiroshima in one short trip without buffer
87- Buying rail passes without route math
88- Stacking long transit day plus heavy nightlife and early temple start
89
90### 6. Match Trip Style
91
92| Traveler | Focus on |
93|----------|----------|
94| Foodie | `food-guide.md`, `osaka.md`, `tokyo.md` |
95| Culture and temples | `kyoto.md`, `regions.md`, `culture.md` |
96| City and nightlife | `tokyo.md`, `osaka.md`, `nightlife.md` |
97| Family | `with-kids.md`, `accommodation.md`, `itineraries.md` |
98| Nature and hiking | `hiking.md`, `experiences.md`, `regions.md` |
99| Mixed route trip | `itineraries.md`, `transport.md`, `regions.md` |
100
101## Common Traps
102
103- Treating Japan as one compact destination with no transfer cost.
104- Choosing too many bases for short trips.
105- Ignoring restaurant and experience reservation timing.
106- Underestimating summer heat and seasonal weather shifts.
107- Not checking if a rail pass actually saves money on planned legs.
108- Assuming etiquette is the same as other major destinations.
109
110## Security & Privacy
111
112**Data that stays local:** Trip preferences in `~/japan/`
113
114**This skill does NOT:** Access files outside `~/japan/` or make network requests.
115
116## Related Skills
117Install with `clawhub install <slug>` if user confirms:
118- `travel` — General trip planning and itinerary structuring
119- `food` — Deeper restaurant and cuisine recommendations
120- `japanese` — Language support for local communication and signage
121- `english` — Backup communication support for multilingual travel
122
123## Feedback
124
125- If useful: `clawhub star japan`
126- Stay updated: `clawhub sync`