Agent skill

Pp Japan Guide

by mvanhorn in mvanhorn/printing-press-library

Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels.

Apache-2.0Auto-check: notes

Install Pp Japan Guide

skills CLI
$ npx skills add mvanhorn/printing-press-library --skill pp-japan-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-japan-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-japan-guide .claude/skills/pp-japan-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pp-japan-guide
GitHub stars
2.1k
Token cost
~2.2k tokens
SKILL.md length
959 words
Files
1
Skills in repo
506
Repo updated
First seen
Licence
Apache-2.0

At a glance

Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels.

  • Works in 3 steps: Install via the Printing Press… → Verify: japan-guide-pp-cli --version → Ensure the reported install directory is…
  • Japan Guide sightseeing facts
  • SKILL.md covers Prerequisites: Install the CLI, When to Use This CLI, Anti-triggers and Unique Capabilities, plus 7 more sections
  • Calls npx and go

What it does

Pp Japan Guide is an agent skill from mvanhorn/printing-press-library. Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels. Use for Japan Guide sightseeing facts or use japan-guide.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

  • Japan Guide sightseeing facts
  • Use japan-guide

Example prompts

  • “/pp-japan-guide”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  2. Verify: japan-guide-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

Read from SKILL.md and the folder at commit d9a1696. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp Japan Guide loads about 2.2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 959 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit d9a1696, republished under its Apache-2.0 licence (© mvanhorn). 959 words, ~2,178 tokens.

Download SKILL.mdSave it as .claude/skills/pp-japan-guide/SKILL.md (or your agent's skills folder).
name
pp-japan-guide
description
Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels. Use for Japan Guide sightseeing facts or `use japan-guide`.
allowed-tools
Read, Bash
author
zjsng
license
Apache-2.0
<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/travel/japan-guide/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Japan Guide

Public source reads require no account or API key.

Prerequisites: Install the CLI

This skill drives the japan-guide-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
    bash
    npx -y @mvanhorn/printing-press-library install japan-guide --cli-only
  2. Verify: japan-guide-pp-cli --version
  3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

bash
go install github.com/mvanhorn/printing-press-library/library/travel/japan-guide/cmd/japan-guide-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Discover destinations and attractions, inspect scoped visit facts, and follow source itinerary links. Preserve seasonal qualifiers and source freshness.

When to Use This CLI

Use Japan Guide as a single source for destination and attraction discovery, scoped visit information, short comparisons, and published itinerary labels. Begin with a source directory and reuse returned page IDs. Source IDs and canonical URLs are the lookup keys.

Anti-triggers

Use another tool for bookings, payments, ticket inventory, route calculation, cross-provider rankings or current opening confirmation. Source recommendations are editorial dots, separate from visitor reviews. Schedules and source plans are reference facts.

Unique Capabilities

These capabilities extend the generated source-link foundation.

Planning facts
  • guide compare — Compare scoped visit facts for up to five source pages and retain per-item failures.

    Compare a small shortlist using source facts.

    bash
    japan-guide-pp-cli guide compare e3001 e3002 --agent
  • guide inspect — Keep shrine, museum and garden schedules attached to their own facilities.

    Use facility-specific admission and closure facts.

    bash
    japan-guide-pp-cli guide inspect e3002 --agent
  • guide inspect — Return source schedules with open_now explicitly unknown.

    Avoid interpreting editorial schedules as live operating status.

    bash
    japan-guide-pp-cli guide inspect e3001 --agent
  • guide inspect — Read saved compact facts while retaining their original source and retrieval dates.

    Save a source snapshot before an offline planning session.

    bash
    japan-guide-pp-cli guide inspect e3001 --cache --agent
  • guide destinations — Return a bounded destination page with request, byte and elapsed-time metrics.

    Limit output and inspect single-page source coverage.

    bash
    japan-guide-pp-cli guide destinations --region kanto --limit 5 --agent

Command Reference

  • guide destinations: one directory; filter by region, name or editorial dots.
  • guide interests: source interest labels and canonical topic links.
  • guide attractions e2164: one destination; filter exact interest tags or name.
  • guide inspect e3002: separate facility hours, closed days, admission, access and dated notices.
  • guide compare e3001 e3002: at most five pages; preserve per-item failures.
  • guide itineraries: regional source index; --destination e2164 reads local plan links.
  • guide itinerary e2400_kanto: bounded source day/stop labels, local visit durations and seasonal closure qualifiers.

Use japan-guide-pp-cli which "temple visit facts" --json and command help for current runtime discovery.

Recipes

Tokyo temples
bash
japan-guide-pp-cli guide attractions e2164 --interest temples --limit 5 --agent --select items

Filter source attraction tags.

Compare facts
bash
japan-guide-pp-cli guide compare e3001 e3002 --agent

Inspect a short list with per-item errors.

Source itinerary
bash
japan-guide-pp-cli guide itineraries --destination e2164 --agent

Return source plans and canonical links.

Auth Setup

Supported public guide pages require no account or API key.

Run japan-guide-pp-cli doctor to verify setup.

Show full SKILL.md (470 more words)Show less

Agent Mode

Use --agent for one compact {meta,results} JSON document. Lists default to 10 rows, allow at most 50, and expose scanned_records and next_offset; continue with --offset. Each invocation scans one source page. An empty filtered result carries a coverage note. --select filters the payload before the envelope; --select items makes results a row array.

Cite returned canonical source URLs. Preserve facility identity, source interest tags and destination/event kinds. Hours use JST; yen admissions use JPY. Keep the exact source year on dated facts. open_now: null is explicit uncertainty. Unknown fields remain unknown; facts_truncated directs the agent to the source for omitted text.

event_calendar separates annual recurrence (explicit_year: null) from a dated source notice. Preserve named seating fees and their release-date qualifiers without treating them as current ticket inventory. extraction_limitations discloses unsupported narrative admission layouts. The MCP comparison field accepts space-separated page IDs, bounded to five; raw endpoint mirrors are hidden.

Offline and failures

guide inspect --cache saves only extracted facts. --offline reads them with freshness: offline_snapshot and meta.source: local; retrieved_at and source_updated retain their original meanings. --cache-dir overrides the facts cache. Other guide commands require live source reads.

Inspect's default --data-source auto tries live facts, then an available saved snapshot after an eligible failure. live_failure and a stderr warning explain the local fallback; it retains original timestamps and does not save a new snapshot without --cache. Use --data-source live or --no-cache to disable fallback. A 429 is an error, not a cache fallback. --rate-limit 0 disables pacing; throttle errors exit 7.

A failed explicit snapshot save propagates an error rather than returning older facts after a successful live read. Inspection's MCP tool conservatively permits local writes because it exposes cache; the other six guide tools are read-only. Guide snapshots are separate JSON files, not SQL resources. This CLI has no sync command; use guide commands for source facts and SQL only for the local framework store.

Inspection's machine-format dry-run returns one simulation object (dry_run, action, would) rather than fetched facts, without a source request or snapshot write.

Comparisons return successful items plus non-throttle fetch_failures, with a stderr warning. All-source failure is an error. Rate limits return a typed 429 error and retry guidance rather than empty data. Layout errors and network errors name the source; follow its canonical URL and retry or select another supported source page. --timeout bounds the whole command.

MCP snapshot caching uses the server-owned cache root. The MCP tool rejects caller-supplied cache-dir; direct CLI invocations retain --cache-dir.

Automatic learning

Recall once before discovery; a cold store can be skipped for the session. Treat learning candidates as trials requiring verification. Teach structural queries with identifiers removed. For deterministic calls, add --no-learn or set JAPAN_GUIDE_NO_LEARN=true.

Agent Feedback

Use japan-guide-pp-cli feedback --help for the local feedback format. Record reproducible source-layout or command-contract failures without credentials or personal data.

© mvanhorn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-skills/pp-japan-guide of mvanhorn/printing-press-library.

Open the folder on GitHubat commit d9a1696

Compare with similar skills

Pp Japan Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp Japan Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Japan Guide this skillmvanhorn/printing-press-library2.1k—~2.2kAutomated safety check: NotesApache-2.0
Node Inspect Debuggeropenclaw/openclaw392k1 repos~894Automated safety check: PassMIT
Blender Motion State Inspectionaffaan-m/ECC276k1 repos~2kAutomated safety check: PassMIT
Mem0 Memory Scopemem0ai/mem067k—~1.1kAutomated safety check: PassApache-2.0
Adding API ScopesPostHog/posthog40k—~2.1kAutomated safety check: PassCustom licence
Inspect Diskfelixrieseberg/windows9524k—~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Node Inspect Debugger

    openclaw/openclaw

    Debug Node.js with node inspect, --inspect, breakpoints, CDP, heap, and CPU profiles.

    392k GitHub starsUsed in 1 repo~894 tokens
    Frontend & DesignAuto-check passed
  • A skill your agent uses when inspecting Blender characters, rigs, poses, animation retargeting, ground contact, facing direction, or model-vs-motion alignment where screenshots alone are not enough.

    276k GitHub starsUsed in 1 repo~2k tokens
    Game DevelopmentAuto-check passed
  • Shows or changes the default Mem0 memory scope, project, session or global, which decides where memories are saved and searched.

    67k GitHub stars~1.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Adding API Scopes

    PostHog/posthog

    Official

    Guidance for adding an API scope object to posthog/scopes.py and making it work for personal API keys, OAuth tokens and MCP clients.

    40k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Inspect Disk

    felixrieseberg/windows95

    Inspect or modify the Windows 95 disk image offline with mtools — no QEMU, no Electron, no boot.

    24k GitHub stars~1.3k tokensUpdated 29 days ago
    Auto-check passed
  • Inspect AI

    a2ui-project/a2ui

    Useful when working with the Inspect AI evaluation framework (e.g., in the eval/ directory).

    17k GitHub starsUsed in 1 repo~226 tokens
    DevelopmentAuto-check passed

More from mvanhorn/printing-press-library

All 506 skills in this repo
  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated today
    Auto-check passed
  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated today
    Auto-check: notes
  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes

Questions about Pp Japan Guide

What does Pp Japan Guide do?

Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels. Pp Japan Guide is an agent skill from mvanhorn/printing-press-library. Find Japan Guide destinations and attractions, inspect scoped visit facts, compare a small shortlist, or read source itinerary labels.

When should I use Pp Japan Guide?

Pp Japan Guide fits situations like: japan Guide sightseeing facts; use japan-guide.

How do I install Pp Japan Guide in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-japan-guide -a claude-code`. Or copy the skill folder (cli-skills/pp-japan-guide in mvanhorn/printing-press-library) into .claude/skills/pp-japan-guide in your project. Claude Code loads it when a task matches its description.

How do I install Pp Japan Guide in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-japan-guide -a codex`. Or copy the skill folder (cli-skills/pp-japan-guide in mvanhorn/printing-press-library) into .agents/skills/pp-japan-guide in your project. Codex loads it when a task matches its description.

Can I use Pp Japan Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-japan-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-japan-guide, .gemini/skills/pp-japan-guide, .github/skills/pp-japan-guide and .opencode/skills/pp-japan-guide in your project.

What does Pp Japan Guide need to run?

Going by SKILL.md and its folder, Pp Japan Guide needs the command-line tools its instructions call (npx and go). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Japan Guide access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pp Japan Guide safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Japan Guide use?

Pp Japan Guide is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Japan Guide use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp Japan Guide?

Skills that share tags, products or a category with Pp Japan Guide: Node Inspect Debugger (openclaw/openclaw, 392k stars), Blender Motion State Inspection (affaan-m/ECC, 276k stars), Mem0 Memory Scope (mem0ai/mem0, 67k stars) and Adding API Scopes (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Japan Guide?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.