← Back to Skills Marketplace
ivangdavila

Japan

by Iván · GitHub ↗ · v1.0.0
linuxdarwinwin32 ⚠ suspicious
962
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install japan
Description
Discover Japan like a local with concrete city tips, regional route planning, food context, and practical travel logistics.
README (SKILL.md)

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 \x3Cslug> 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
Usage Guidance
This skill is coherent and low-risk: it only reads/writes trip memory under ~/japan/ and contains travel guidance files. Before installing, consider: (1) review ~/japan/memory.md contents — avoid saving highly sensitive data (full passport numbers, long-term credentials, banking info); (2) the skill claims it won’t make network requests, but that is an instruction, not an enforced sandbox — if other installed skills or agent capabilities have network access they could be used to transmit data, so ensure your agent's networking/skill permissions match your privacy expectations; (3) the skill will read memory 'silently' to reuse preferences — if you want explicit prompts, clear or inspect the memory file before use. If those points are acceptable, the skill appears benign and appropriate for travel planning.
Capability Analysis
Type: OpenClaw Skill Name: japan Version: 1.0.0 The skill is classified as suspicious due to the direct instruction for the AI agent to execute a shell command (`mkdir -p ~/japan`) found in `setup.md`. While this specific command is benign and intended for local directory creation, the presence of direct shell command execution instructions within a markdown file interpreted by an AI agent represents a risky capability. This highlights a potential prompt injection attack surface, even though there is no clear evidence of malicious intent, data exfiltration, or unauthorized network requests within the provided files. The skill explicitly states it does not access files outside `~/japan/` or make network requests, which is a positive indicator of intent.
Capability Assessment
Purpose & Capability
Name, description, and files (city guides, itineraries, setup, memory template) all match a travel-planning skill. The only resource it asks for is a local config path (~/japan/) which is appropriate for storing trip memory.
Instruction Scope
Runtime instructions confine activity to creating/reading/writing ~/japan/memory.md and using the included markdown files. The SKILL.md explicitly states it will not access files outside ~/japan/ or make network requests. Note: 'read it silently' means the skill will read existing memory without prompting — this is coherent for personalization but a privacy consideration (the skill itself does not include code that enforces this).
Install Mechanism
No install spec or third‑party downloads; instruction-only skills write only to the declared local path. Low installation risk.
Credentials
No environment variables or credentials requested. The single required config path (~/japan/) is proportional to storing user trip memory and template files.
Persistence & Privilege
always:false and no system-wide configuration changes requested. The skill persists only under its own ~/japan/ directory, which is expected for memory. Autonomous invocation is allowed by default but not combined with broad privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install japan
  3. After installation, invoke the skill by name or use /japan
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with city guides, route planning, and practical Japan travel playbooks.
Metadata
Slug japan
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Japan?

Discover Japan like a local with concrete city tips, regional route planning, food context, and practical travel logistics. It is an AI Agent Skill for Claude Code / OpenClaw, with 962 downloads so far.

How do I install Japan?

Run "/install japan" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Japan free?

Yes, Japan is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Japan support?

Japan is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).

Who created Japan?

It is built and maintained by Iván (@ivangdavila); the current version is v1.0.0.

💬 Comments