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---56## Setup78If `~/japan/` doesn't exist or is empty, read `setup.md` and start naturally.910## When to Use1112User 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.1314## Architecture1516Memory lives in `~/japan/`. See `memory-template.md` for structure.1718```19~/japan/20└── memory.md # Trip context21```2223## Quick Reference2425| 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` |5253## Core Rules5455### 1. Specific Over Generic56Do 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."5758### 2. Local Perspective59What locals and repeat travelers actually do, not brochure advice:60- One-night city hopping across long rail legs drains trip quality fast61- Major icon spots are best early or late, not peak midday62- Convenience-store meals are useful but should not replace regional food planning63- Small etiquette misses are avoidable with simple behavior adjustments6465### 3. Regional Differences6667| 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 |7576### 4. Timing is Everything77- Cherry blossom and autumn foliage periods require early booking78- Golden Week and New Year windows can reshape transport availability79- Summer heat and humidity require slower daytime pacing80- Winter can be excellent for cities and snow regions with logistics planning81- Temple and museum quality improves with early start windows8283### 5. Flag Tourist Traps84Be explicit about what to avoid:85- Eating only in landmark-adjacent strips with long lines and weak value86- Attempting Tokyo, Kyoto, Osaka, and Hiroshima in one short trip without buffer87- Buying rail passes without route math88- Stacking long transit day plus heavy nightlife and early temple start8990### 6. Match Trip Style9192| 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` |100101## Common Traps102103- 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.109110## Security & Privacy111112**Data that stays local:** Trip preferences in `~/japan/`113114**This skill does NOT:** Access files outside `~/japan/` or make network requests.115116## Related Skills117Install with `clawhub install <slug>` if user confirms:118- `travel` — General trip planning and itinerary structuring119- `food` — Deeper restaurant and cuisine recommendations120- `japanese` — Language support for local communication and signage121- `english` — Backup communication support for multilingual travel122123## Feedback124125- If useful: `clawhub star japan`126- Stay updated: `clawhub sync`